排查 reCAPTCHA 集成问题

本文档列出了开发者在其环境中使用 reCAPTCHA 时可能会遇到的常见 reCAPTCHA 集成问题。

网站密钥无效

如果您看到 Invalid site key 错误，则表示您的 reCAPTCHA 网站密钥已失效。创建新密钥并将其安装在网页上。

密钥迁移失败

在以下情况下，网站密钥可能无法迁移：

• 您或您的组织可以创建的项目数量已超出上限。

  如需解决此问题，您可以重复使用现有项目、申请增加项目创建配额，或等待自动化迁移完成。

• 您的工作区组织已限制创建新的 Google Cloud项目。

  如需在 Google 管理控制台中启用 Google Cloud 服务，请与您的管理员联系。如需了解详情，请参阅为用户启用或停用 Google Cloud 。

SecurityError：阻止了来源为“https://www.google.com”的框架访问来源为“&ltyour domain&gt”的框架

如果 reCAPTCHA widget HTML 元素在最终用户点击复选框后以编程方式被移除，通常会发生此错误。我们建议使用 grecaptcha.enterprise.reset() JavaScript 函数重置 reCAPTCHA widget。

受支持的网域列表中不包含 localhost

默认情况下，不支持 localhost 网域。如果您想继续支持这些网域进行开发，可以将其添加到网站密钥的支持网域列表中。 前往 Google Cloud 控制台，更新受支持网域的列表。我们建议您为开发和生产环境使用不同的密钥，并且仅允许在开发网站密钥中使用 localhost。

创建评估时，reCAPTCHA 返回了 BROWSER_ERROR

当 reCAPTCHA 脚本无法执行 execute 操作时，就会出现 BROWSER_ERROR 令牌。在大多数情况下，这是由于客户端网络故障或超时造成的。您必须使用 JavaScript 重试 execute()。