跳到主内容
版本: 1.x

SYNC171: 本地数据库初始化失败

这意味着什么​

本设备上的某个本地数据库无法创建或删除。

请重启 WCPOS 并再试一次。如果持续失败，可能是设备存储空间不足，或浏览器配置限制了存储；请释放空间，若问题依旧，请联系支持团队。

该怎么做​

请重启 WCPOS；如果反复发生，说明本设备上的本地数据需要修复。WCPOS 不会自行重试——请在您准备好时重试。

您的数据​

该更改已保存在本设备上，但尚未传到您的商店。如果问题持续存在，请导出诊断信息并联系 WCPOS 支持团队。

故障排查​

  1. 重启 WCPOS 并再次尝试同一操作——大多数初始化失败都是暂时的。
  2. 检查设备上的可用存储空间；当磁盘或浏览器的存储配额已满时，创建本地数据库会直接失败。
  3. 在网页版中，请检查浏览器是否允许该站点使用持久化存储——隐私窗口和“阻止所有数据”设置不允许。
  4. 如果持续失败，请导出调试信息并联系支持团队。

在哪里查看​

当 WCPOS 能够保存此错误时，它会被记录在触发该错误的设备上。打开 商店健康 → 日志（导航抽屉底部的心跳图标），找到标有此代码的条目并展开：展开后的行会显示通俗易懂的原因，以及故障发生时捕获的上下文。对于商店请求，该上下文可能包含服务器自身的错误代码（serverCode）、HTTP status 或 endpoint；具体显示哪些字段取决于故障发生的位置。上报问题时，请使用日志页面顶部的 复制调试信息（在手机和平板上为 分享调试信息），而不要使用截图：它会打包应用版本、连接状态和最近的错误。日志最多保留 30 天，因此请趁问题还新鲜时收集。此外，也请复制在 POS 能够写入自身日志条目之前出现的任何浏览器控制台错误。

除应用内日志外，此故障还可能在以下位置留下线索：

  • 控制台（网页版和桌面版）：同一开发者工具中的 控制台 选项卡会记录客户端错误，包括那些在 POS 尚未能写入自身日志条目之前发生的错误。

详细信息​

  • 代码： SYNC171（LOCAL_DB_SETUP_FAILED）
  • 严重程度： 错误
  • 引入版本： WCPOS 1.10.0