写代码对接ChatGPT、Claude、Gemini时,最抓狂的不是模型不聪明,而是它压根不理你:401、403、429轮流来。下面这套排查我自己用得最多,基本能把“API不通”从玄学拉回现实。
一类错误 401无效密钥或签名不对
看到invalid_api_key、Unauthorized,先别怀疑人生,八成是复制多了空格、少了前缀,或者把测试环境的Key塞进了生产。
- 确认Key来自正确平台:OpenAI、Anthropic、Google不要混用
- 检查请求头:Bearer格式是否写对
- 换一个最小请求验证,别一上来就带一堆参数
二类错误 429限流或额度没了
429看着像网络问题,其实更像“你用太猛了”。
- 控制并发,做指数退避重试
- 核对账单与配额,Gemini和Claude的项目/组织别选错
- 长文本能切就切,提示词用KISS原则:简单点反而更稳
三类错误 403地区或风控拦截
403很多时候不是你没权限,是平台觉得你“可疑”。公司内网、机房IP、频繁换节点都容易触发。
