易君召
易君召
发布于 2026-10-30 / 0 阅读
0

HTTP 状态码分类 & 常见码

HTTP 状态码分为 5 大类:

  • 1xx 信息响应:请求已接收,继续处理

  • 2xx 成功响应:请求成功

  • 3xx 重定向:需要进一步操作完成请求

  • 4xx 客户端错误:请求有问题,服务器无法处理

  • 5xx 服务端错误:服务器处理请求出错

1xx 信息类

  • 100 Continue:继续,客户端应继续发送请求

  • 101 Switching Protocols:切换协议(如升级为 WebSocket)

2xx 成功类

  • 200 OK:请求成功,正常返回数据

  • 201 Created:资源创建成功(常用于 POST)

  • 202 Accepted:请求已接收,但处理尚未完成(异步任务)

  • 204 No Content:成功,但无返回内容(删除常用)

  • 206 Partial Content:范围请求成功,返回部分资源(断点续传)

3xx 重定向类

  • 301 Moved Permanently:永久重定向,资源地址永久变更

  • 302 Found:临时重定向(旧规范,大部分浏览器按 307 行为)

  • 303 See Other:用 GET 访问新地址

  • 304 Not Modified:资源未修改,走缓存(协商缓存)

  • 307 Temporary Redirect:临时重定向,保持原请求方法

  • 308 Permanent Redirect:永久重定向,保持原请求方法

4xx 客户端错误(请求问题)

  • 400 Bad Request:请求参数 / 格式错误

  • 401 Unauthorized:未认证,需要登录 / 令牌

  • 403 Forbidden:已认证,但没有权限访问

  • 404 Not Found:资源不存在

  • 405 Method Not Allowed:请求方法不允许(接口只支持 GET,你发 POST)

  • 406 Not Acceptable:服务器无法返回客户端要求格式

  • 408 Request Timeout:请求超时

  • 409 Conflict:资源冲突(如重复创建同名资源)

  • 410 Gone:资源曾经存在,现已永久删除

  • 413 Payload Too Large:请求体过大

  • 414 URI Too Long:URL 太长

  • 415 Unsupported Media Type:媒体类型不支持(Content-Type 不对)

  • 422 Unprocessable Entity:格式对,但校验不通过(参数校验失败)

  • 429 Too Many Requests:请求过于频繁,限流

5xx 服务端错误

  • 500 Internal Server Error:服务器内部未知错误

  • 501 Not Implemented:服务器不支持该请求方法

  • 502 Bad Gateway:网关 / 反向代理拿到上游无效响应

  • 503 Service Unavailable:服务不可用(停机、过载、维护)

  • 504 Gateway Timeout:网关等待上游服务超时

  • 505 HTTP Version Not Supported:不支持该 HTTP 版本