跳到主内容
版本: 1.x

SYNC999: 同步意外错误

这意味着什么​

同步遇到了意外问题。

您的销售数据在本设备上是安全的。请等待自动重试；如果此代码持续出现，请导出诊断信息并联系支持团队。

该怎么做​

请再次尝试该操作。WCPOS 会自动重试。

您的数据​

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

故障排查​

  1. 不要想当然地认为此代码会自动重试。请先展开日志条目：如果它确认该变更已进入队列，WCPOS 会自动重试，因此请保持应用打开，让队列自行处理完毕。
  2. 如果错误显示引擎常驻进程缺失，或写入在返回变更 ID 之前就已失败，则没有任何内容进入队列——请回到该记录或订单并重新保存。
  3. 展开日志条目，记下事件代码和任何 serverCode：999 代码表示具体原因尚无专属代码，因此这些上下文正是支持团队所需要的。
  4. 如果该代码持续出现，请使用“复制调试信息”并联系支持团队——正是通过上报，才能为它添加专属代码。

在哪里查看​

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

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

  • 网络检查器（网页版和桌面版）：打开开发者工具——在浏览器中按 F12，或在桌面应用的菜单中选择 高级 → 切换开发者工具——然后选择 网络 选项卡。请先遵循本页的重试指引；只有当这些步骤说明可以安全操作时，才重现该操作。失败的请求会显示 HTTP 状态码和原始响应正文，其中包括那些从未传到 POS 日志的错误页面。

详细信息​

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