[Cloudflare Turnstile] Error: XXXXXX.

详情可参考:Cloudflare开发者文档-错误代码

本篇为翻译(咱也不知道咋的,他官网都有错乱。。)

错误回调将检索错误代码作为其第一个参数。错误代码由前三个数字分隔成系列。error-code (一般为六位数)

❗ 注意
当错误代码标有 *** 时,表示可以忽略其余数字,供内部使用。

以下代码会在Cloudflare Turnstile(也就是CF验证器)执行错误时在后台(F12控制台)输出,但输出的是警告(warning)

错误代码

错误代码 描述 重试 故障排除
100*** 初始化问题:在开始挑战之前初始化 Turnstile 时出现问题。 这可能是由已解决的质询的旧实例引起的。建议重新加载页面并重新启动 Turnstile。在连续故障时,这表示设备已自动化。
102*** 无效的参数:访客发送了无效的参数,作为对 Turnstile 的质询的一部分。 是的 建议重试质询。在连续故障时,这表示设备已自动化。
102*** 103*** 104*** 106*** 无效的参数:访客发送了无效的参数,作为对 Turnstile 的质询的一部分。 是的 建议重试质询。在连续失败时,这表明设备已自动化,您必须通过其他方式验证访问者的真实性。
105*** Turnstile API 兼容性:Turnstile 以已弃用或无效的方式调用。 建议再次参考 Turnstile 文档并刷新页面以获取最新的 Turnstile 版本。
110100 110110 无效的 sitekey:使用无效的 sitekey 或不再有效的 sitekey 调用 Turnstile。 通过 Cloudflare 仪表板↗验证提供的 sitekey 是否仍然有效。
110200 未知域:不允许使用域。 Turnstile 用于不允许使用此小部件的域。确保通过 Cloudflare dashboard ↗ 在小部件配置中允许该域。
110420 无效作:当提交不受支持或格式不正确的作时,会发生此错误。 确保作符合指定的结构,仅包含有效字符,并遵守记录的长度限制。有关更多信息,请参阅 客户端配置 。
110430 无效的 cData:Turnstile 中的此错误是指在处理自定义数据 (cData) 时遇到的问题。当提供的 cData 不符合预期格式或包含无效字符时,会出现此错误。 确保 cData 符合指定的结构,仅包含有效字符,并遵守记录的长度限制。有关更多信息,请参阅 客户端配置 。
110500 不支持的浏览器:访客正在使用不支持的浏览器。 鼓励访客升级其浏览器或进行验证。有关更多信息,请参阅支持的浏览器。
110510 不一致的用户代理:访客在解决 Turnstile 的整个过程中提供了不一致的用户代理。 访客可能启用了浏览器扩展或设置来欺骗其用户代理,并应禁用它们以继续。
11060* 质询超时:访客解决质询的时间过长,质询超时。 是的 重试质询。访客还可能将系统时钟设置为错误的日期。
11062* 质询超时:此错误仅适用于可见模式。访客花了太长时间来解决交互式挑战,因此挑战变得过时了。 是的 重置 Widget 并重新初始化它,以便访客有机会再次解决 Widget。
120*** Cloudflare 员工的内部错误。 仅由 Cloudflare 支持工程师在调试时遇到。
200010 缓存无效:意外缓存了 Turnstile 的某些部分。 鼓励访客清除其缓存。
200100 时间问题:访客的时钟不正确。 鼓励访客将他们的时钟设置为正确的时间。
200500 加载错误:无法加载 challenges.cloudflare.com 下的 iframe。 确保您的内容安全策略允许这样做,或鼓励访客减少其安全首选项,以防其用户代理阻止第三方 iframe。
300*** 通用客户端执行错误:访客在解决挑战时发生不明错误。 是的 可能是自动访客。重试质询。如果后续多次失败,请验证访客。
400020 无效的 sitekey:sitekey 无效或不存在。 确保 sitekey 有效且存在。
400030 Invalid size(大小无效):提供的大小不是有效的选项。 确保 size 是有效选项之一。
400040 Invalid theme(无效主题):提供的主题不是有效的选项。 确保主题为 , 或 .light dark auto
600*** 质询执行失败:访客未能解决旋转门质询。也被失败的测试 sitekey 使用。 是的 可能是自动访客。重试质询。如果后续多次失败,请验证访客。

错误代码和300*** 600***

错误代码系列和(例如“300*** 600*** 600010: The generic_challenge_failure”)是 Turnstile 在检测到潜在机器人或异常访客行为的情况下生成的响应。

您可以使用以下建议对这些错误代码进行故障排除:

  1. 验证您的浏览器兼容性。
    • Turnstile 支持除 Internet Explorer 之外的所有主流浏览器。
    • 确保您的浏览器是最新的。有关更多信息,请参阅我们支持的浏览器。
  2. 禁用您的浏览器扩展。
    • 某些浏览器扩展(例如广告拦截器)可能会阻止 Turnstile 需要运行的脚本。
    • 暂时禁用所有扩展并重新加载页面。
  3. 启用 JavaScript。
    • Turnstile 需要 JavaScript 才能运行。确保在浏览器设置中启用它。有关启用 JavaScript 的说明,请参阅浏览器的文档。
  4. 尝试隐身模式或私人模式。
    • 使用浏览器的隐身或隐私模式来排除由扩展或缓存数据引起的问题。
  5. 测试其他浏览器或设备。
    • 切换到其他浏览器或设备,查看问题是否特定于您当前的设置。
  6. 避免使用 VPN 或代理。
    • 某些虚拟专用网络 (VPN) 或代理可能会干扰 Turnstile。暂时禁用它们以进行测试。
  7. 切换到其他网络。
    • 您当前的网络可能存在限制,导致 Turnstile 质询失败。尝试切换到其他网络,例如移动热点。
posted @ 2025-07-13 17:38  小兴365  阅读(195)  评论(0)    收藏  举报