SYNC101: 本地数据库写入失败
这意味着什么
此更改无法保存到本地数据库,目前仅存在于本设备上。
请不要清除或重新加载本地数据。在重试或进行任何修复之前,请导出诊断信息并联系支持团队。
该怎么做
请导出诊断信息并联系支持团队。WCPOS 不会自行重试——请在您准备好时重试。
您的数据
本设备上的数据可能面临风险——请不要清除本地数据。如果问题持续存在,请导出诊断信息并联系 WCPOS 支持团队。
故障排查
- 如果日志条目指明了某条记录,请记下它——那就是尚未保存的更改。站点和凭据类写入可能只会指明失败的操作和错误;请在继续之前记录这些细节。
- 不要清除站点数据、重置应用或卸载:未保存的更改仅存在于本设备上,清除本地存储会将其永久删除。
- 检查设备的可用存储空间——磁盘已满或浏览器存储配额耗尽是本地写入失败最常见的原因。
- 重启 WCPOS 一次,并做一处小而无害的编辑,确认新的更改能否保存。
- 如果写入持续失败,请在日志页面使用“复制调试信息”,并在尝试任何修复之前联系支持团队。
在哪里查看
当 WCPOS 能够保存此错误时,它会被记录在触发该错误的设备上。打开 商店健康 → 日志(导航抽屉底部的心跳图标),找到标有此代码的条目并展开:展开后的行会显示通俗易懂的原因,以及故障发生时捕获的上下文。对于商店请求,该上下文可能包含服务器自身的错误代码(serverCode)、HTTP status 或 endpoint;具体显示哪些字段取决于故障发生的位置。上报问题时,请使用日志页面顶部的 复制调试信息(在手机和平板上为 分享调试信息),而不要使用截图:它会打包应用版本、连接状态和最近的错误。日志最多保留 30 天,因此请趁问题还新鲜时收集。此外,也请复制在 POS 能够写入自身日志条目之前出现的任何浏览器控制台错误。
除应用内日志外,此故障还可能在以下位置留下线索:
- 控制台(网页版和桌面版):同一开发者工具中的 控制台 选项卡会记录客户端错误,包括那些在 POS 尚未能写入自身日志条目之前发生的错误。
详细信息
- 代码:
SYNC101(LOCAL_DB_WRITE_FAILED) - 严重程度: 错误
- 引入版本: WCPOS 1.10.0