TL;DR
记住三句话:2xx 成功、3xx 重定向、4xx 客户端问题(改请求)、5xx 服务端问题(查服务器)。最常遇到:404、403、429、500、502、504。
分类
| 区间 | 含义 |
|---|---|
| 1xx | 信息性响应 |
| 2xx | 成功 |
| 3xx | 重定向 |
| 4xx | 客户端错误 |
| 5xx | 服务端错误 |
高频状态码
| 状态码 | 含义 | 排查方向 |
|---|---|---|
| 200 | OK | 正常 |
| 201 | Created | 资源已创建 |
| 204 | No Content | 成功但无响应体 |
| 301 / 302 | 永久 / 临时重定向 | 检查 Location |
| 304 | Not Modified | 缓存命中 |
| 400 | Bad Request | 请求格式/参数错误 |
| 401 | Unauthorized | 未认证,检查 token |
| 403 | Forbidden | 认证了但无权限,检查权限/防火墙/WAF |
| 404 | Not Found | 路径/资源不存在 |
| 405 | Method Not Allowed | 方法不对,检查 GET/POST |
| 409 | Conflict | 状态冲突 |
| 429 | Too Many Requests | 限流,等待重试 |
| 500 | Internal Server Error | 服务端异常,看日志 |
| 502 | Bad Gateway | 上游无响应,检查后端是否活着 |
| 503 | Service Unavailable | 过载/维护中 |
| 504 | Gateway Timeout | 上游超时 |
排查口诀
- 4xx 改请求,5xx 查服务;
- 403 先确认 WAF/防火墙/CDN 拦截,别只查应用;
- 502/504 先看上游进程与端口,再看代理配置。
常见问题
403 和 401 有什么区别?
401 是未认证(缺 token 或未登录),403 是认证了但没有权限,也可能是 WAF/防火墙/CDN 拦截——遇到 403 先查这些,别只查应用。
502 和 504 分别是什么问题?
502 Bad Gateway 是上游(后端进程/端口)没响应或返回异常;504 Gateway Timeout 是上游响应超时。都先看上游进程和端口,再看代理配置。
404 一定是服务器问题吗?
不一定。404 表示路径或资源不存在,先检查请求 URL 和路由,再确认文件或接口是否真的部署了。
429 怎么处理?
429 是限流,客户端应等待并重试,或降低请求频率;如果是 CDN/WAF 限流,检查触发规则。
304 表示出错了吗?
没有。304 Not Modified 表示缓存命中,浏览器或代理直接使用本地缓存,不是错误。
来源
- MDN HTTP 状态码文档