Google ReCaptchaV2免费版超100万次使用后响应及验证方案咨询

一、g-captcha-response的表现 #

当免费版月度100万次配额用尽后，用户完成前端验证时，g-captcha-response依然会生成正常长度的字符串，不会是空值。真正的配额限制是在后端调用Google验证API时触发的，前端不会直接感知到配额不足。

二、后端验证API的响应格式 #

配额用尽时，Google验证API会返回明确的错误响应，格式如下：

{
  "success": false,
  "error-codes": ["quota-exceeded"]
}

其中error-codes里的quota-exceeded是判断配额耗尽的核心标识。

三、模拟验证场景的方法 #

• 使用Google官方测试密钥：测试环境中，测试密钥可模拟包括配额耗尽在内的各种错误场景，方便本地验证流程。
• 本地模拟后端逻辑：临时在后端代码中添加分支，手动返回包含quota-exceeded错误码的响应，验证业务流程是否符合预期。

四、配额用尽后允许登录的实践 #

• 核心逻辑放在后端：不要依赖前端判断配额状态，后端先调用Google验证API，若返回quota-exceeded错误，则跳过ReCaptcha验证，直接执行登录逻辑。
• 前端保留基础校验：继续保留g-captcha-response非空的判断，避免用户未完成前端验证就提交请求，但不要以此作为配额判断依据。
• 提前预警：关注Google发送的配额接近用尽的邮件提醒，及时升级付费版或调整验证策略，减少对用户的影响。

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