跳到主内容
版本: 1.x

SYNC311: 数据结构不匹配

这意味着什么

本地数据来自不兼容的版本,暂时无法打开。

当本设备可能存有从未传到您商店的更改时,请不要重置受影响的本地集合——重置会删除唯一的本地副本。请导出诊断信息以便支持团队调查,然后联系支持团队获取恢复指引。

该怎么做

请导出诊断信息并联系支持团队。请在完成上述更改后再重试;不做更改就重试同样会失败。

您的数据

本设备上的数据可能面临风险——请不要清除本地数据。如果问题持续存在,请导出诊断信息并联系 WCPOS 支持团队。

故障排查

  1. 不要重置或删除受影响的集合——如果本设备上存有从未传到商店的更改,本地副本就是唯一的副本。
  2. 检查本设备上的应用最近是否升级或降级过;应用与其存储数据之间的版本不匹配是常见的触发原因。
  3. 将本设备上的 WCPOS 更新到最新版本,然后重新打开商店。
  4. 如果该集合仍然无法打开,请使用“复制调试信息”并联系支持团队获取恢复指引,在此之前不要改动本地数据。

在哪里查看

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

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

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

详细信息

  • 代码: SYNC311SCHEMA_MISMATCH
  • 严重程度: 错误
  • 引入版本: WCPOS 1.10.0