Google reCAPTCHA Enterprise站点密钥状态“未完成”，求完成方案

核心排查与操作步骤 #

• 检查密钥关联资源配置
  登录Google Cloud控制台的reCAPTCHA Enterprise页面，找到目标站点密钥，确认关联的域名、Android包名或iOS bundle ID和公司网站完全匹配（注意区分example.com和www.example.com这类带/不带前缀的差异）。配置不匹配会导致密钥始终处于未完成状态。

• 确认API启用状态
  进入Google Cloud API库，搜索reCAPTCHA Enterprise API，确保该API已启用。未启用的话，密钥无法正常激活。

• 全面替换网站端集成代码
  仅替换后台密钥字段不够，需同步更新前端和后端的验证逻辑：

  1. 前端加载脚本要换成Enterprise版本：https://www.google.com/recaptcha/enterprise.js?render=你的新站点密钥
  2. 后端验证请求要调用Enterprise接口：https://recaptchaenterprise.googleapis.com/v1/projects/你的项目ID/assessments?key=你的新密钥
     普通reCAPTCHA v2/v3的代码和Enterprise不兼容，必须完全替换对应脚本与接口。

• 触发验证请求激活密钥
  密钥状态更新需要Google检测到实际验证请求。完成配置后，在网站上触发一次需要验证的操作（比如提交表单、登录），等待5-10分钟后刷新reCAPT控制台页面，查看状态是否变更为已完成。

常见误区修正 #

• 别混淆Enterprise密钥和普通reCAPTCHA密钥：两者的集成方式、控制台入口完全不同，普通密钥无法直接用于Enterprise服务。
• 排查服务器网络问题：确保网站服务器IP未被Google API拦截，可在服务器上测试调用Enterprise验证接口，确认能正常获取响应。

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