看懂报错:谁的问题,怎么判断
把所有 API 报错分成三类:你的问题、中转站的问题、上游的问题。给一张速查表和判断流程。
工具更新 2026-10-28· 真机验证 2026-10-28 by 码农阿风
三类责任
| 类型 | 典型错误 | 判断 |
|---|---|---|
| 你的问题 | 401、400、404、上下文超限 | 换站也一样 |
| 中转站的问题 | 令牌无效、无可用渠道、站点 502 | 换站就好 |
| 上游的问题 | 5xx、529 overloaded、地区限制 | 所有站都一样 |
判断流程
报错了
↓
换个站点再试
↓
还是同样的错 → 你的问题或上游的问题
好了 → 那个站的问题
↓
换模型再试
↓
好了 → 该模型/渠道的问题
还是错 → 你的请求或账号
速查表
| 错误码 | 大概率责任方 |
|---|---|
| 401 | 你(Key) |
| 403 | 你(权限)或上游(地区) |
| 404 | 你(模型名) |
| 400 | 你(参数) |
| 429 | 中转站(限流)或你(并发) |
| 500/502/503 | 上游或站点 |
| 504 | 站点网关 |
| 529 | 上游(Anthropic 容量) |
一个习惯
报错时先保存完整原文。 包含 request id 的报错,服务商才能查。
我们把常见报错都整理成了独立页面,直接搜错误码就能找到对应的排查路径。