HTTP 状态码速查
常用状态码含义与排查提示，支持按码值/名称/含义搜索
2xx 成功
| 200 | OK | 请求成功 一切正常。 |
| 201 | Created | 已创建（常用于 POST 建资源） 返回体里通常带新资源的 Location。 |
| 204 | No Content | 成功但无返回体 DELETE 成功常用；前端别指望读 body。 |
3xx 重定向
| 301 | Moved Permanently | 永久重定向 搜索引擎会转移权重；浏览器会缓存，改回来要清缓存。 |
| 302 | Found | 临时重定向 不缓存；需要保留原地址权重时用 307/308 更明确。 |
| 304 | Not Modified | 缓存仍有效 配合 ETag / If-None-Match，能省流量。 |
4xx 客户端错误
| 400 | Bad Request | 请求参数有误 先检查必填字段、格式、JSON 是否合法。 |
| 401 | Unauthorized | 未认证（没登录 / token 无效） 不是密码错那么简单——检查 Authorization 头有没有带对。 |
| 403 | Forbidden | 已认证但无权限 / 被 IP 或防火墙拒绝 Nginx 拦截的 403 通常没有 JSON body；应用层 403 一般有结构化错误。 |
| 404 | Not Found | 资源不存在 查路径拼写、路由方法、SPA fallback 是否生效。 |
| 405 | Method Not Allowed | 方法不被允许 路径对但动词不对（如对 GET 接口发了 POST）。 |
| 409 | Conflict | 资源冲突 常见于唯一约束冲突、乐观锁版本不一致。 |
| 413 | Payload Too Large | 请求体过大 检查 Nginx client_max_body_size 与后端限制。 |
| 415 | Unsupported Media Type | Content-Type 不支持 发 JSON 记得 Content-Type: application/json。 |
| 422 | Unprocessable Entity | 格式对但语义校验失败 字段能解析但业务规则不过，错误详情常在 body。 |
| 429 | Too Many Requests | 触发限流 看 Retry-After 头，别裸重试，用指数退避。 |
5xx 服务端错误
| 500 | Internal Server Error | 服务端异常 先看服务端日志堆栈，前端无能为力。 |
| 502 | Bad Gateway | 网关收到无效上游响应 常见于后端没起来/端口没监听；重启服务后等 10–30 秒再判断。 |
| 503 | Service Unavailable | 服务暂不可用 过载或维护中；检查服务健康状态与连接数。 |
| 504 | Gateway Timeout | 网关等上游超时 后端处理太慢；查慢 SQL、慢接口，或调大网关超时。 |
只有管理员能看到，不公开