跳到主内容
版本: 1.x

CHECKOUT101: 结账失败，购物车安全

这意味着什么​

结账未能完成，购物车仍可安全用于重试。

请检查购物车并重试结账；当前的购物车内容已被保留。

该怎么做​

请再次尝试该操作。WCPOS 不会自行重试——请在您准备好时重试。

您的数据​

订单本身是安全的，未发生变化。

故障排查​

  1. 检查购物车——它没有变化——然后再次尝试结账。
  2. 如果以同样的方式失败，请展开日志条目：serverCode 和 status 会说明商店是否拒绝了该订单以及原因。
  3. 反复出现且状态为 500 类的失败属于网站问题——请在 WooCommerce → 状态 → 日志中查看故障时段的 PHP 错误。
  4. 如果原因指明了某个具体的订单行，请将其移除、完成本次销售，之后再排查该产品。

在哪里查看​

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

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

  • 网络检查器（网页版和桌面版）：打开开发者工具——在浏览器中按 F12，或在桌面应用的菜单中选择 高级 → 切换开发者工具——然后选择 网络 选项卡。请先遵循本页的重试指引；只有当这些步骤说明可以安全操作时，才重现该操作。失败的请求会显示 HTTP 状态码和原始响应正文，其中包括那些从未传到 POS 日志的错误页面。
  • 服务器端 POS 日志：在 WP Admin 中打开 POS → 设置 → 工具 → 日志。此页面记录在服务器端产生的 POS 相关警告和错误，这些内容可能永远不会出现在应用内。菜单上的红色标记表示有未读的服务器端错误。
  • WooCommerce → 状态 → 日志：在 WordPress 网站上，查看最新的 fatal-errors-*.log 是否有 PHP 崩溃记录，以及以故障相关插件命名的任何日志来源。商店返回的 500 类错误几乎总会在这里留下原因。

详细信息​

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