Google reCAPTCHA V3本地正常线上失效，求调试方案

针对你本地正常、线上部署后fetch请求停滞的问题，可按以下步骤排查：

1. 验证线上服务器的网络连通性 #

线上服务器可能因防火墙、DNS解析或地域限制无法访问Google的reCAPTCHA验证接口：

• 在服务器终端执行curl命令测试连通性：

  curl -X POST "https://www.google.com/recaptcha/api/siteverify?secret=你的密钥&response=任意测试token"
  

  如果没有返回JSON响应，说明网络存在限制，需联系服务器运维调整防火墙规则，或配置代理访问Google服务。

2. 增强错误日志与调试信息 #

当前代码的错误捕获不够详细，无法定位具体问题：

• 在fetch前后添加日志，确认参数和请求触发情况：

  console.log('准备发起reCAPTCHA验证，参数:', { secret_key, token, url });
  // fetch请求...
  

• 完善catch块的错误输出，打印完整错误栈：

  .catch(error => {
      console.error('reCAPTCHA验证请求失败详情:', error.stack);
      res.status(500).json({ error: error.message });
  });
  

通过日志可以明确是请求无法发出、超时还是响应解析失败。

3. 核对reCAPTCHA控制台配置细节 #

• 确认线上域名精确匹配：如果线上是www.example.com，需同时添加example.com和www.example.com；域名不要带http://或https://前缀。
• 检查密钥一致性：线上环境使用的secret_key必须与reCAPTCHA控制台中V3类型的密钥完全一致，避免混用V2密钥。

4. 调整fetch请求的参数传递方式 #

当前代码将参数放在URL中并使用POST方法，虽然符合文档要求，但部分服务器环境可能对这种方式有拦截。建议改为标准POST表单提交：

const url = 'https://www.google.com/recaptcha/api/siteverify';
fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
    },
    body: new URLSearchParams({
        secret: secret_key,
        response: token,
    }),
})

同时确认线上环境安装的node-fetch版本与本地一致（v2和v3版本用法有差异）。

5. 添加请求超时机制 #

线上网络延迟可能导致fetch请求无限等待，需设置超时：

const timeoutPromise = new Promise((_, reject) => {
    setTimeout(() => reject(new Error('reCAPTCHA验证请求超时')), 10000); // 10秒超时
});

Promise.race([
    fetch(url, { method: 'post' }),
    timeoutPromise
])
.then(response => response.json())
// 后续逻辑...

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