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