咨询：reCAPTCHA v3验证出现未记录的incorrect-captcha-sol错误

我们在验证reCAPTCHA v3响应时，偶尔会收到官方文档未记录的incorrect-captcha-sol错误，返回格式如下：

{
  "success": false,
  "error-codes": [
    "incorrect-captcha-sol"
  ]
}

目前已有其他开发者遇到相同问题，但暂无官方解决方案，以下是可尝试的处理建议：

• 重试验证请求：该错误多为偶发，可能是Google服务端临时异常。可间隔2-3秒后重新发送验证请求，不要直接阻断用户操作。
• 规范验证触发时机：确保reCAPTCHA v3的execute调用是在用户执行关键操作（如表单提交）前触发，避免过早调用导致token过期或失效。
• 核对验证参数：检查发送到Google验证接口的参数：
  • secret密钥是否与后台配置一致，无泄露或拼写错误
  • response是否为前端返回的完整token值
  • remoteip尽量传递用户真实IP地址，不要使用代理或服务器IP
• 排查第三方工具影响：如果使用了验证码代填、自动化测试工具等，这类工具生成的token可能被Google判定为无效，建议在测试环境禁用后再验证。
• 监控错误场景：记录错误出现的浏览器、用户操作路径、时间段等信息，若错误率持续上升，可通过Google Cloud支持渠道提交反馈。

内容的提问来源于stack exchange，提问作者jckdnk111