| 范围 | 400-499 |
|---|---|
| 含义 | 错误来自请求方（或请求与当前资源状态不匹配） |
| 规范 | RFC 9110 §15.5 |
| 常见码 | 400、401、403、404、405、408、409、413、429 |
4xx 不等于「不能重试」：408（超时）与 429（限流）在退避后可以重试；403/404 无意义重试只会放大日志。排障先看响应体中的错误码与说明字段。
高频 4xx 归因快速表
| 状态码 | 第一优先排查点 |
|---|---|
| 400 | 请求体 JSON/表单格式、必填参数、非法字符 |
| 401 | 缺少或过期凭证；看 WWW-Authenticate 提示的认证方案 |
| 403 | 凭证有效但权限不足；也可能是网段/IP 白名单或 WAF 拦截 |
| 404 | URL 拼写、路由未注册、后端服务版本不一致 |
| 405 | 请求方法不对；看 Allow 头允许哪些方法 |
| 429 | 触发限流；按 Retry-After 退避 |
查看错误详情而不是只看码
查看错误详情而不是只看码
curl -si https://api.example.com/items/999 | head -20