跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

质询解决问题

最后更新 查看 MarkdownAgent 设置

质询循环

您可能会遇到质询循环,在其中质询不断重新出现而未能解决。这是在我们检测到强烈机器人信号的非常具体的情况下发生的。如果您是合法的真实用户,您可以按照下面的故障排除指南解决问题或提交反馈报告。质询循环可能由于几个原因发生:

  • 网络问题:网络连接不良或不稳定会阻碍质询的完成。
  • 浏览器配置:某些浏览器设置或扩展程序可能会阻止执行质询所需的脚本。
  • 不支持的浏览器:使用 Turnstile 不支持的浏览器。
  • 禁用了 JavaScript:Turnstile 依赖 JavaScript 正常运行。
  • 检测错误:如果 Turnstile 怀疑存在类似机器人的行为,您可能会遇到要求验证的重复质询。

大多数质询很快就能完成,通常只需几秒钟。如果花费的时间更长,请确保您的网络稳定并按照故障排除步骤操作。

专用访问令牌请求上的 401 响应

当质询页面加载时,浏览器可能会从 /cdn-cgi/challenge-platform/.../pat/... 端点请求专用访问令牌 (PAT)。在无法发出令牌的设备、浏览器或网络上,此请求返回 HTTP 401。

这种响应是预期的,并不意味着访问者被阻止或小组件发生故障。Cloudflare 回退到标准质询,访问者照常继续进行。对该请求出现 401——例如,在浏览器开发人员工具或 HAR 捕获中看到的——本身并不是错误配置、误报或拦截的标志。有关更多详细信息,请参阅专用访问令牌。

Turnstile 质询期间由于子域网络请求失败

在查看浏览器开发人员工具或为 Turnstile 捕获 HAR 时,通常会发现由于 DNS 主机查找错误,对特定子域的某些请求失败。这些子域位于 challenges.cloudflare.com 和 dnstest.dev 父域之下,对这些子域的请求是 Turnstile 正常执行的一部分。不过,不应将这些错误视为失败的根本原因,因为它们对访问者是非阻塞 的。

鉴于这些 DNS 主机查找失败是预期的 并且对 Turnstile 的执行非致命,请避免将其作为致命执行错误暴露,特别是在基于处理程序的 Turnstile 集成(例如 Web 视图嵌入)的情况下。为了获得更精细的控制,请考虑丢弃源自对 *.challenges.cloudflare.com 通配符的请求的网络错误,同时保留 challenges.cloudflare.com 顶点的错误可见性。

故障排除

请按照以下步骤确保您的环境配置正确。

  1. 验证您的浏览器兼容性。
    • Turnstile 支持除 Internet Explorer 之外的所有主流浏览器。
    • 确保您的浏览器已更新到最新版本。有关更多信息,请参阅我们的支持的浏览器。
    • 使用兼容性检查工具 ↗运行测试。
  2. 禁用您的浏览器扩展程序。
    • 某些浏览器扩展程序(例如广告拦截器)可能会阻止 Turnstile 运行所需的脚本。
    • 临时禁用所有扩展程序并重新加载页面。
  3. 启用 JavaScript。
    • Turnstile 需要 JavaScript 才能运行。确保在您的浏览器设置中启用了它。有关启用 JavaScript 的说明,请参阅浏览器的文档。
  4. 尝试无痕或私密模式。
    • 使用浏览器的无痕或私密模式以排除由扩展程序或缓存数据引起的问题。
  5. 测试另一个浏览器或设备。
    • 切换到不同的浏览器或设备,以查看问题是否针对您当前的设置。
  6. 避免使用 VPN 或代理。
    • 某些虚拟专用网络 (VPN) 或代理可能会干扰 Turnstile。临时禁用它们以进行测试。
  7. 切换到不同的网络。
    • 您当前的网络可能会有一些限制,导致 Turnstile 质询失败。尝试切换到另一个网络,例如移动热点。

收集诊断信息

如果问题持续存在,请在联系网站管理员或 Cloudflare 支持之前收集以下信息:

  • 在复现问题时捕获的 HAR 文件。对于质询循环,请在浏览器开发人员工具中启用 Preserve log(保留日志),然后再复现问题。你可能还需要选择 Disable cache(禁用缓存)。
  • 在同一会话期间导出的浏览器控制台日志。

分步说明请参阅 收集站点故障排除信息。

WebView 与移动应用实现

如果质询仅在原生应用的 WebView 中失败,请查看 移动端实现 中所需的 WebView 设置。常见原因包括禁用了 JavaScript、缺少 DOM 存储或 cookie 支持、阻止访问 challenges.cloudflare.com,以及会话期间发生变化的 User Agent。

如果上述方法都不能解决您的问题,请将错误代码和 Ray ID 发送给网站管理员,或者通过选择 Submit Feedback(提交反馈),通过 Turnstile 小组件提交反馈报告。

这篇文档对您有帮助吗?