HTTP 状态码速查表
把 HTTP 状态码按 1xx-5xx 分类整理,每个码标注含义和常见原因,接口排障和 Nginx 配置时对照查。
返回 系统与运维1xx 信息 Informational 2
100 Continue客户端应继续发送请求体,常用于大上传前的预检
101 Switching Protocols协议切换,WebSocket 升级握手时返回
2xx 成功 Success 4
200 OK请求成功,GET 返回资源,PUT/PATCH 返回更新结果
201 Created资源创建成功,POST 请求后返回,Location 头指向新资源
204 No Content成功但无响应体,DELETE 请求常用
206 Partial Content范围请求成功,断点续传 / 视频拖拽时返回
3xx 重定向 Redirection 5
301 Moved Permanently永久重定向,SEO 权重转移,HTTP→HTTPS 跳转用
302 Found临时重定向,不转移权重
304 Not Modified资源未修改,用缓存,条件请求(If-None-Match)命中
307 Temporary Redirect临时重定向,保持请求方法不变(302 可能改 POST 为 GET)
308 Permanent Redirect永久重定向,保持请求方法不变
4xx 客户端错误 Client Error 9
400 Bad Request请求语法错误,如 JSON 格式不合法、缺少必填参数
401 Unauthorized未认证,缺少或无效的 Token/Cookie,需登录
403 Forbidden已认证但无权限,如普通用户访问管理接口
404 Not Found资源不存在,URL 路径错误或资源已删除
405 Method Not Allowed请求方法不允许,如对只支持 GET 的接口发 POST
408 Request Timeout请求超时,客户端未在规定时间内发送完请求
409 Conflict资源冲突,如重复创建、并发修改
413 Payload Too Large请求体过大,Nginx client_max_body_size 限制
429 Too Many Requests请求频率超限,限流触发(如 Nginx limit_req)
5xx 服务端错误 Server Error 7
500 Internal Server Error服务端内部错误,代码异常、空指针等
501 Not Implemented服务器不支持该请求方法
502 Bad Gateway网关收到上游无效响应,Nginx 连不上后端或后端崩溃
503 Service Unavailable服务不可用,过载、维护中或限流,Retry-After 头提示重试时间
504 Gateway Timeout网关等待上游超时,Nginx proxy_read_timeout 超限
505 HTTP Version Not Supported不支持 HTTP 协议版本
511 Network Authentication Required需网络认证,公共 WiFi 登录页场景
💡 提示
- 502 vs 504:502 是后端返回了无效响应(崩溃/拒绝连接),504 是后端连接成功但响应超时。
- 401 vs 403:401 是"你是谁"(未认证),403 是"你不能做"(已认证但无权限)。
- Nginx 413 解决:调大 client_max_body_size;429 解决:检查 limit_req 限流配置。