# SYNC331: 本地记录出现偏差

## 这意味着什么[​](#what-this-means "直接链接到 这意味着什么")

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

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

## 该怎么做[​](#what-to-do "直接链接到 该怎么做")

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

## 您的数据[​](#your-data "直接链接到 您的数据")

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

## 故障排查[​](#troubleshoot "直接链接到 故障排查")

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

## 在哪里查看[​](#where-to-look "直接链接到 在哪里查看")

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

## 详细信息[​](#details "直接链接到 详细信息")

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