做自动化脚本、Bot或者接工作流时,最崩溃的不是写代码,而是突然冒出API key invalid、401、403、网络超时。别急,这篇我按自己踩坑顺序,给你一份“照着查就能定位”的清单,ChatGPT、Claude、Gemini都通用。
先看报错类型 别一上来就重装
很多人把所有问题都当“密钥错了”,结果白折腾。
- 401:密钥无效、没带上、格式拼错、项目没开通
- 403:权限不足、地区/风控限制、额度策略拦截
- 429:限流或额度用完
- 超时/ENOTFOUND:网络/DNS/代理问题,跟密钥没关系
API密钥无效的高频原因
参考一些插件排错经验里提到的“API密钥错误”和依赖配置坑,我总结最常见的就这几类:
- 复制多了空格或换行:尤其是环境变量里,末尾多一个空格就能让你怀疑人生
- 用错了平台的Key:OpenAI、Anthropic、Google的Key不能混用,别把Gemini的Key塞进Claude配置里
- 请求头写错:Authorization前缀、Header字段名大小写、Bearer漏写
- 项目没开通计费/权限:Key是真的,但账号没开通对应API权限,也会被拒
403访问受限 重点查地区和出口
403最烦,因为它经常不告诉你“到底哪里不行”。我的经验是先查出口IP和代理规则,再查账户权限。
