跳到主内容
版本: 1.x

SYNC121: 同步无法连接

这意味着什么​

目前无法连接到您的商店，因此更改会暂时保留在本设备上。

请检查网络连接并继续离线工作；当商店恢复可访问时，同步会自动重试。

该怎么做​

您可以继续工作——WCPOS 会自动处理。WCPOS 会自动重试。

您的数据​

该更改已保存在本设备上，但尚未传到您的商店。

故障排查​

  1. 继续销售——销售数据已保存在本设备上，商店恢复响应后同步会自动继续。
  2. 检查收银机本身是否在线：本设备能否打开其他任何网站？
  3. 在同一设备的浏览器标签页中打开您商店自己的网站；如果它同样无法加载，说明是网站或其主机出了故障，而不是 POS。
  4. 如果网站能打开但 POS 仍显示离线，说明两者之间有环节在拦截 API 请求——可能是 VPN、防火墙、广告拦截器或安全插件；网络检查器会显示是哪个请求失败。

在哪里查看​

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

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

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

详细信息​

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