- 200 OK
- 成功。
- 201 Created
- 创建成功,通常配合 Location 头返回新资源地址。
- 204 No Content
- 成功但没有响应体,删除接口常用。
- 206 Partial Content
- 断点续传和视频拖动进度时返回。
- 301 Moved Permanently
- 永久重定向,浏览器和搜索引擎会缓存,改错了很难纠正。
- 302 Found
- 临时重定向,不传递权重。
- 304 Not Modified
- 内容没变,用缓存即可。配合 ETag 或 Last-Modified。
- 307 Temporary Redirect
- 和 302 类似但保持原请求方法,POST 不会变成 GET。
- 308 Permanent Redirect
- 和 301 类似但保持原请求方法。
- 400 Bad Request
- 请求本身有问题,通常是参数格式或 JSON 语法错。
- 401 Unauthorized
- 没登录或凭据无效。名字容易误导,它说的是未认证。
- 403 Forbidden
- 已认证但没权限。也常见于 WAF 和防盗链拦截。
- 404 Not Found
- 资源不存在。
- 405 Method Not Allowed
- 路径存在但不接受这个方法,检查是不是该用 POST。
- 409 Conflict
- 和当前状态冲突,比如唯一键重复。
- 413 Payload Too Large
- 请求体超限,常是 nginx 的 client_max_body_size。
- 415 Unsupported Media Type
- Content-Type 不对,忘了写 application/json 最常见。
- 422 Unprocessable Content
- 格式对但语义不合法,表单校验失败常用。
- 429 Too Many Requests
- 被限流,看 Retry-After 头。
- 499 Client Closed Request
- nginx 私有码,客户端在服务端响应前断开,多半是上游太慢。
- 500 Internal Server Error
- 服务端异常,去看服务端日志。
- 502 Bad Gateway
- 网关拿到了上游的无效响应,通常是上游挂了或崩溃。
- 503 Service Unavailable
- 暂时不可用,过载或维护中。
- 504 Gateway Timeout
- 网关等上游超时。检查 nginx 的 proxy_read_timeout。