常见报错状态码
下面这些是最常见的 HTTP 错误状态码。排查时建议先看状态码,再结合返回的 message 判断是参数、权限、限流还是上游异常。
| 状态码 | 含义 |
|---|---|
400 Bad Request | 格式错误或请求内容不能被服务器理解,通常意味着客户端参数填写错误。 |
401 Unauthorized | API 密钥验证未通过。需检查 API Key 是否正确、令牌是否过期,或请求头是否填写错误。 |
403 Forbidden | 一般是权限不足,比如当前令牌没有对应分组、模型或功能的访问权限。 |
404 Not Found | 请求的资源未找到,一般是接口地址、请求路径或模型名填写错误。 |
413 Request Entity Too Large | 请求体过大。需要减小图片、文件或文本内容后再重试。 |
429 Too Many Requests | 请求数量过多,个人或服务器并发过高,触发了限流保护。 |
500 Internal Server Error | 服务器内部错误,可能是站点异常、渠道异常,或上游服务炸了。 |
503 Service Unavailable | 服务器暂时不可用,通常是维护中、上游拥堵,或当前渠道没有可用容量。 |
504 Gateway Timeout | 被请求服务器处理超时。重新尝试或重新 Roll 仍无效时,通常表示上游已经卡住。 |
