仅生产环境出现Google认证失败500错误排查求助

1. 核对Netlify环境变量配置 #

• 确认GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、REDIRECT_URI三个核心变量在Netlify生产环境变量中无多余空格、换行或拼写错误。尤其注意REDIRECT_URI必须是Netlify生产域名的HTTPS地址（如https://your-site.netlify.app/api/callback），和Google Cloud Console配置完全一致。
• 避免将本地.env文件的内容直接复制粘贴到Netlify，手动输入或用Netlify CLI批量导入，防止隐藏字符导致变量读取失败。

2. 检查Google Cloud Console OAuth配置 #

• 确保Netlify生产域名的回调地址已添加到授权重定向URI列表，不要只保留本地的localhost地址。
• 若应用处于测试状态，仅测试用户列表内的账号能完成授权，生产环境需将应用切换为发布状态，否则会触发权限校验失败，导致后端500。

3. 排查Netlify Functions部署细节 #

• 确认Googleauth.ts和callback.ts放置在netlify/functions/目录下（或自定义的函数目录，需在netlify.toml中配置），函数名称与请求路径对应。
• 查看Netlify部署日志，确认googleapis等依赖包已正确安装，无缺失或版本不兼容的报错。
• 打开Netlify控制台的Functions日志，查看500错误的具体堆栈信息——这是定位问题最直接的方式，通常能看到如invalid_client、redirect_uri_mismatch等明确错误提示。

4. 验证代码中的环境变量读取与错误处理 #

• 确保代码中通过process.env.VAR_NAME读取环境变量，不要使用自定义的.env读取逻辑（Netlify Functions默认注入环境变量）。
• 在callback.ts的授权码交换逻辑中添加try-catch，将错误信息打印到日志，避免直接抛出未捕获的异常导致500错误。

5. 检查Netlify安全与超时设置 #

• 确认Netlify未开启额外的防火墙或CORS限制，可直接访问回调路径测试是否能正常响应。
• 若授权流程中请求Google API耗时较长，在netlify.toml中调整函数超时时间：

  [functions]
  timeout = 10 # 单位：秒，根据实际情况调整
  

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