跳到主内容
版本: 1.x

SYNC331: 本地记录出现偏差

这意味着什么​

设备上的此记录与您的商店不一致，需要在本地修复。

您录入的内容没有任何一项在等待发送。本设备上某条由您商店所有的记录的副本，与商店中的副本产生了偏差；请按日志中显示的状态进行修复。

该怎么做​

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

您的数据​

订单和产品数据不受影响。如果问题持续存在，请导出诊断信息并联系 WCPOS 支持团队。

故障排查​

  1. 展开日志条目——其上下文会指明集合、记录 ID、状态以及发现差异的检测器。
  2. 对于被更改或缺失的记录，请对受影响的集合运行定向下载，让设备用商店的副本替换自己的副本。
  3. 对于已删除的记录，请移除本地副本；服务器上的删除标记不得被下载。
  4. 将 WP Admin 中的记录与 POS 显示的内容进行比较；价格或库存差异是可见的表征。
  5. 如果修复后同一批记录反复出现，说明商店中存储的摘要已过时——这通常发生在跳过 WooCommerce 保存钩子的批量写入之后（CSV 导入、迁移插件、WP-CLI 或直接执行 SQL）。记录本身通常没有问题；网站管理员可以通过重建完整性索引来清除该状态，而当某个区间持续报告相同差异时，WCPOS 会自动安排这次重建。
  6. 如果重建之后仍然出现，请导出调试信息并联系支持团队。

在哪里查看​

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

详细信息​

  • 代码： SYNC331（LOCAL_RECORD_DIVERGED）
  • 严重程度： 警告
  • 引入版本： WCPOS 1.10.0