SYNC131: 商店服务器错误
这意味着什么
您的商店返回了错误,因此此操作未能完成。
已连接到商店,但其服务器未能处理该请求。这是网站的问题,而不是 POS 的问题,因此仅靠重试可能没有帮助:请检查网站的错误日志,或请主机服务商代为检查,然后再重试。本设备上没有任何内容丢失。
该怎么做
请再次尝试该操作。WCPOS 不会自行重试——请在您准备好时重试。
您的数据
该更改已保存在本设备上,但尚未传到您的商店。如果问题持续存在,请导出诊断信息并联系 WCPOS 支持团队。
故障排查
- 展开日志条目,记下 status、endpoint 和 serverCode——它们说明服务器在失败时正在做什么。
- 在网站上打开 WooCommerce → 状态 → 日志,查看故障时段前后最新的 fatal-errors 日志;500 类响应几乎总会在那里留下 PHP 错误。
- 如果故障是在网站的插件、主题或 PHP 更新之后开始出现的,请首先怀疑该变更,并将其回滚或停用。
- 如果 WooCommerce 的日志中什么都没有,请向主机服务商索取同一时间段的服务器 PHP 错误日志。
- 服务器端的原因修复之后,请从 POS 重试——该更改仍保存在本设备上。
在哪里查看
当 WCPOS 能够保存此错误时,它会被记录在触发该错误的设备上。打开 商店健康 → 日志(导航抽屉底部的心跳图标),找到标有此代码的条目并展开:展开后的行会显示通俗易懂的原因,以及故障发生时捕获的上下文。对于商店请求,该上下文可能包含服务器自身的错误代码(serverCode)、HTTP status 或 endpoint;具体显示哪些字段取决于故障发生的位置。上报问题时,请使用日志页面顶部的 复制调试信息(在手机和平板上为 分享调试信息),而不要使用截图:它会打包应用版本、连接状态和最近的错误。日志最多保留 30 天,因此请趁问题还新鲜时收集。此外,也请复制在 POS 能够写入自身日志条目之前出现的任何浏览器控制台错误。
除应用内日志外,此故障还可能在以下位置留下线索:
- 网络检查器(网页版和桌面版):打开开发者工具——在浏览器中按 F12,或在桌面应用的菜单中选择 高级 → 切换开发者工具——然后选择 网络 选项卡。请先遵循本页的重试指引;只有当这些步骤说明可以安全操作时,才重现该操作。失败的请求会显示 HTTP 状态码和原始响应正文,其中包括那些从未传到 POS 日志的错误页面。
- 服务器端 POS 日志:在 WP Admin 中打开 POS → 设置 → 工具 → 日志。此页面记录在服务器端产生的 POS 相关警告和错误,这些内容可能永远不会出现在应用内。菜单上的红色标记表示有未读的服务器端错误。
- WooCommerce → 状态 → 日志:在 WordPress 网站上,查看最新的
fatal-errors-*.log是否有 PHP 崩溃记录,以及以故障相关插件命名的任何日志来源。商店返回的 500 类错误几乎总会在这里留下原因。 - 网站的 PHP 错误日志:如果 WooCommerce 的日志页面在故障时段没有任何记录,请向主机服务商索取 PHP 错误日志——有些致命错误只在服务器层面被捕获。
详细信息
- 代码:
SYNC131(STORE_SERVER_ERROR) - 严重程度: 错误
- 引入版本: WCPOS 1.10.0