[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 在检测到潜在机器人或异常访客行为的情况下生成的响应。
您可以使用以下建议对这些错误代码进行故障排除:
- 验证您的浏览器兼容性。
- Turnstile 支持除 Internet Explorer 之外的所有主流浏览器。
- 确保您的浏览器是最新的。有关更多信息,请参阅我们支持的浏览器。
- 禁用您的浏览器扩展。
- 某些浏览器扩展(例如广告拦截器)可能会阻止 Turnstile 需要运行的脚本。
- 暂时禁用所有扩展并重新加载页面。
- 启用 JavaScript。
- Turnstile 需要 JavaScript 才能运行。确保在浏览器设置中启用它。有关启用 JavaScript 的说明,请参阅浏览器的文档。
- 尝试隐身模式或私人模式。
- 使用浏览器的隐身或隐私模式来排除由扩展或缓存数据引起的问题。
- 测试其他浏览器或设备。
- 切换到其他浏览器或设备,查看问题是否特定于您当前的设置。
- 避免使用 VPN 或代理。
- 某些虚拟专用网络 (VPN) 或代理可能会干扰 Turnstile。暂时禁用它们以进行测试。
- 切换到其他网络。
- 您当前的网络可能存在限制,导致 Turnstile 质询失败。尝试切换到其他网络,例如移动热点。

浙公网安备 33010602011771号