常见报错对照表：401/403/404/429/500 分别意味着什么

为什么需要一个对照表

看到报错的第一反应往往是「站点挂了」。但相当一部分报错和站点无关 —— 有的是 Key 的问题，有的是请求的问题，有的是你网络的问题。

4xx 系列：通常是你的问题

400 Bad Request

含义：请求格式不对。

常见成因：JSON 格式错误、必填字段缺失、参数类型不对、上下文超出长度限制。

先查什么：看响应体里的 message 字段，多数站会说明具体哪里不对。该找谁：你自己。

401 Unauthorized

含义：鉴权失败。

常见成因：Key 写错或有空格、Key 被撤销、认证头格式错（Bearer 前缀漏了，或用了 Anthropic 的 x-api-key 而站点要 Authorization）。

该找谁：你自己。

403 Forbidden

含义：有身份但没权限。

常见成因：Key 被禁用（风控）、触发 IP 限制、模型不在可用范围内。

易误判点：Claude Code 的 Status 403 常常不是 Key 错，而是环境变量没生效。要确认 ANTHROPIC_BASE_URL 在新终端里可见。

该找谁：你先查，确认后找站点客服。

402 / 余额不足

含义：钱不够了。先查什么：站点后台余额。该找谁：你自己。

404 Not Found

两种可能：

1. 端点未实现 —— 该站不支持你请求的接口（如 /v1/responses）
2. 模型名写错

先查什么：

curl https://站点/v1/models -H "Authorization: Bearer $KEY"

对照返回的模型 id。

429 Too Many Requests

含义：触发频率或并发限制。

常见成因：短时间并发过高、单账号配额用尽、被判定为异常流量。

处理方式：指数退避重试 + 降低并发。不要立刻重试，那只会让限流持续更久。

该找谁：你自己（降频）；持续被限流则找客服问单账号上限。

5xx 系列：通常是站点或上游的问题

这些情况下你能做的只有切备用通道。

没有状态码的情况

连接超时 vs 响应超时很重要：前者请求可能没发出去，切换通道是安全的；后者可能已计费，切换要谨慎。

处理顺序（建议照做）

1. 看响应体的 message        ← 多数情况能直接告诉你怎么改
2. 查余额与 Key 状态          ← 解决相当一部分「站点挂了」的误判
3. 用最小 curl 请求测试       ← 区分「请求问题」与「服务问题」
4. 换网络（手机热点）         ← 排除本地线路
5. 看本站监测页 / 官方群      ← 确认是否普遍故障
6. 切备用通道                ← 先恢复业务
7. 事后分析日志              ← 不要在故障中做深度分析

第 6、7 步的顺序是关键：生产环境出问题时，优先恢复服务，而不是先在故障现场做分析。

一个原则

先确认「是不是只有你出问题」。

如果别人也报错，那是站点的问题，你只需要切通道；如果只有你报错，那问题在你这一侧，切通道解决不了。

相关阅读

• 中转站突然报错或变慢，怎么判断是谁的问题
• Claude Code 接入中转站完整配置教程（含排错）
• 怎么给项目配置多家 API 互备