跳到主内容
版本: 1.x

AUTH311: REST 路由缺失

这意味着什么​

WCPOS 商店路由不可用。

请网站管理员检查是否有安全或代理插件剥离了 WCPOS 的请求标头。

该怎么做​

需要先更改设置，此功能才能正常工作。请在完成上述更改后再重试；不做更改就重试同样会失败。

您的数据​

订单和产品数据不受影响。如果问题持续存在，请咨询管理您 WordPress 网站的人员。

故障排查​

  1. 确认 WCPOS 已在网站上启用：WP Admin → 插件。
  2. 在浏览器中测试两种受支持的 REST 形式：您商店的 /wp-json/ 地址和 /index.php?rest_route=/。只有当两个地址都不返回 JSON 时，才判定 REST 被拦截。
  3. 如果两种 REST 形式都无法使用，请询问网站管理员是否有安全插件、代理或 CDN 剥离了 WCPOS 的请求标头或拦截了 REST 请求——防火墙规则和禁用 REST API 的加固选项是常见元凶。
  4. 在某些主机上，重新保存固定链接（设置 → 固定链接 → 保存）可以恢复缺失的 REST 路由。

在哪里查看​

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

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

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

详细信息​

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