OpenAI Compatible API 错误码怎么看：常见报错和排查顺序

接口一旦上线，报错就会成为常态。问题不在于会不会错，而在于能不能快速知道错在哪。

先看鉴权类错误

如果一上来就是 401 或 403，先检查 Key、Header 和权限范围，别先怀疑模型。

再看参数类错误

很多 400 问题都来自请求体不兼容，常见的是模型名、消息格式和流式参数写错。

最后看上游类错误

502、503、504 往往说明问题在上游或中间代理，重点看超时、重试和健康检查。

排查顺序

• 先确认请求有没有到达网关
• 再确认网关有没有把请求转出去
• 最后确认上游有没有返回有效响应

结论

错误码不是结论，只是线索。把排查顺序固定下来，能省很多人工。