跳到主内容
版本: 1.x

AUTH301: 身份验证插件冲突

这意味着什么​

另一个身份验证插件正在阻止 WCPOS 连接。

请网站管理员解决指明的插件冲突后再重新登录。

该怎么做​

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

您的数据​

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

故障排查​

  1. 展开日志条目——在商店报告了冲突插件的情况下，它会指明该插件。
  2. 请网站管理员检查该插件的设置：大多数身份验证插件都可以将 WCPOS 的 REST 路由列为例外，而不必彻底停用。
  3. 更改完成后，请在收银机上重新登录。
  4. 如果不清楚是哪个插件冲突，请在暂存副本上测试，逐个停用安全和登录类插件。

在哪里查看​

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

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

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

详细信息​

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