切换工具
HTTP 状态码速查表
1xx~5xx 全量状态码中文速查:含义、排障要点、搜索过滤
61 / 61 条
| 状态码 | 分类 | 英文名 | 说明 |
|---|---|---|---|
| 100 | 1xx | Continue | 继续。客户端应继续发送请求体,用于带 Expect: 100-continue 的大请求预检。 |
| 101 | 1xx | Switching Protocols | 切换协议。服务器同意升级协议,最常见于 WebSocket 握手(Upgrade: websocket)。 |
| 102 | 1xx | Processing | 处理中(WebDAV)。服务器已收到请求但尚未完成,用于防止客户端超时。 |
| 103 | 1xx | Early Hints | 早期提示。在最终响应前先返回 Link 头,让浏览器预加载 CSS/JS 等资源。 |
| 200 | 2xx | OK | 成功。GET 请求返回资源本体,POST 返回处理结果。 |
| 201 | 2xx | Created | 已创建。资源创建成功,响应头应带 Location 指向新资源地址。 |
| 202 | 2xx | Accepted | 已接受。请求已进入异步处理队列,结果需轮询或回调获取,不保证最终成功。 |
| 203 | 2xx | Non-Authoritative Information | 非权威信息。代理/网关返回的元信息与源服务器不完全一致。 |
| 204 | 2xx | No Content | 无内容。处理成功但没有返回体,常用于 PUT/DELETE/PATCH 的成功响应。 |
| 205 | 2xx | Reset Content | 重置内容。要求客户端重置当前视图(如清空表单),响应无本体。 |
| 206 | 2xx | Partial Content | 部分内容。Range 断点续传/视频拖动的标准响应,Content-Range 标明区间。 |
| 207 | 2xx | Multi-Status | 多状态(WebDAV)。一个请求涉及多个资源,各自状态在 XML/JSON 体里分别给出。 |
| 208 | 2xx | Already Reported | 已报告(WebDAV)。绑定集合中重复成员不再重复展开。 |
| 226 | 2xx | IM Used | 已使用实例操作(Delta encoding)。返回的是增量而非全量。 |
| 300 | 3xx | Multiple Choices | 多种选择。资源有多个表示形式(如多语言版本),由客户端选择。 |
| 301 | 3xx | Moved Permanently | 永久重定向。资源已永久迁移,SEO 权重转移用这个;浏览器会缓存。 |
| 302 | 3xx | Found | 临时重定向。资源暂时在别处,浏览器不缓存;登录后跳转常用。 |
| 303 | 3xx | See Other | 参见其他。明确要求用 GET 去取响应,POST 成功后重定向到结果页的规范做法。 |
| 304 | 3xx | Not Modified | 缓存有效。协商缓存命中(If-None-Match/If-Modified-Since),无响应体,省流量。 |
| 307 | 3xx | Temporary Redirect | 临时重定向且保持方法。302 会被浏览器把 POST 改成 GET,307 严格保留原方法与请求体。 |
| 308 | 3xx | Permanent Redirect | 永久重定向且保持方法。301 的严格版,重定向后不复用缓存的旧方法。 |
| 400 | 4xx | Bad Request | 请求语法错误/参数校验失败。最常见于 JSON 格式错、缺必填字段。 |
| 401 | 4xx | Unauthorized | 未认证。缺少或无效的登录凭证(token/签名),响应头应带 WWW-Authenticate。 |
| 402 | 4xx | Payment Required | 要求付费。标准保留未广泛使用,个别 API 用它表示额度/套餐不足。 |
| 403 | 4xx | Forbidden | 已认证但无权限。与 401 的区别:身份没问题,但该身份不被允许访问此资源。 |
| 404 | 4xx | Not Found | 资源不存在。也可能是权限不想暴露时的伪装返回。 |
| 405 | 4xx | Method Not Allowed | 方法不允许。URL 存在但不支持该 HTTP 方法(如对只读接口发 DELETE),响应 Allow 头列出可用方法。 |
| 406 | 4xx | Not Acceptable | 无法满足 Accept 协商。服务器给不出客户端要求的内容格式。 |
| 407 | 4xx | Proxy Authentication Required | 需要代理认证。客户端需先通过代理服务器的身份验证。 |
| 408 | 4xx | Request Timeout | 请求超时。客户端发送请求太慢,服务器超时断开。 |
| 409 | 4xx | Conflict | 状态冲突。资源当前状态与请求冲突,如并发编辑、重复创建、版本不匹配。 |
| 410 | 4xx | Gone | 资源已永久消失。比 404 更明确的"不再存在且无新地址",爬虫会移除收录。 |
| 411 | 4xx | Length Required | 要求 Content-Length。服务器拒绝不定长的请求。 |
| 412 | 4xx | Precondition Failed | 前置条件失败。If-Match/If-Unmodified-Since 等条件不满足,乐观锁冲突的典型返回。 |
| 413 | 4xx | Content Too Large | 请求体过大。上传文件超限的标配返回,配合 429 的区别:这是体积不是频率。 |
| 414 | 4xx | URI Too Long | URI 过长。GET 塞了过多参数时出现,改 POST 请求体。 |
| 415 | 4xx | Unsupported Media Type | 媒体类型不支持。Content-Type 不是接口接受的格式(如要 JSON 发了 form)。 |
| 416 | 4xx | Range Not Satisfiable | 区间不可满足。断点续传的 Range 超出资源大小。 |
| 417 | 4xx | Expectation Failed | Expect 头无法满足。 |
| 418 | 4xx | I'm a teapot | 我是一个茶壶。1998 愚人节彩蛋(HTCPCP),请求用茶壶煮咖啡;现也常被占用于彩蛋页。 |
| 421 | 4xx | Misdirected Request | 请求发错地方。HTTP/2 多路复用下连接选错服务器(SNI 不匹配)。 |
| 422 | 4xx | Unprocessable Content | 语义错误。格式合法但业务校验失败(字段值非法),表单/API 校验的推荐返回。 |
| 423 | 4xx | Locked | 资源已锁(WebDAV)。别人锁着编辑中。 |
| 424 | 4xx | Failed Dependency | 依赖请求失败(WebDAV)。批量操作里前一步挂了导致本步不执行。 |
| 425 | 4xx | Too Early | 过早。服务器不愿处理可能被重放攻击利用的早期请求。 |
| 426 | 4xx | Upgrade Required | 要求升级协议。客户端需切换到 TLS/HTTP2 等(Upgrade 头指明)。 |
| 428 | 4xx | Precondition Required | 要求前置条件。服务器要求请求带 If-Match 防止丢失更新(先读后写竞态)。 |
| 429 | 4xx | Too Many Requests | 请求过多。限流触发,标准响应头 Retry-After 给出重试等待时间。 |
| 431 | 4xx | Request Header Fields Too Large | 请求头过大。常见于 Cookie 堆积过多,清理站点 Cookie 可解。 |
| 451 | 4xx | Unavailable For Legal Reasons | 因法律原因不可用。地区屏蔽/版权下架使用的正式状态码。 |
| 500 | 5xx | Internal Server Error | 服务器内部错误。未捕获异常的兜底返回,排查看服务端日志堆栈。 |
| 501 | 5xx | Not Implemented | 未实现。服务器不支持该功能(方法/协议特性),不是临时故障。 |
| 502 | 5xx | Bad Gateway | 网关错误。代理/网关从上游收到无效响应——上游挂了、崩溃、返回格式错。 |
| 503 | 5xx | Service Unavailable | 服务不可用。过载或维护中,常配 Retry-After;负载均衡摘除节点时常见。 |
| 504 | 5xx | Gateway Timeout | 网关超时。上游在时限内没响应——慢 SQL、死循环、依赖服务卡死的典型信号。 |
| 505 | 5xx | HTTP Version Not Supported | HTTP 版本不支持。 |
| 506 | 5xx | Variant Also Negotiates | 变体协商配置错误(透明内容协商)。服务器端配置问题。 |
| 507 | 5xx | Insufficient Storage | 存储不足(WebDAV)。服务器没空间完成请求。 |
| 508 | 5xx | Loop Detected | 检测到循环(WebDAV)。处理时陷入无限循环。 |
| 510 | 5xx | Not Extended | 未扩展。要求的扩展策略服务器不支持。 |
| 511 | 5xx | Network Authentication Required | 需要网络认证。公共 WiFi 登录墙的返回,响应体是登录页。 |
收录 RFC 9110(原 7231)、RFC 6585、RFC 7725、RFC 9110 之外的 WebDAV 扩展码共 61 个,是排障接口、写网关/监控告警规则时的速查底表。
使用说明
按分类 tab(信息/成功/重定向/客户端错误/服务端错误)浏览,或在搜索框输入码值(502)、英文短语(Unauthorized)与中文关键词(限流)即时过滤。
每个状态码的说明都写明了高频排障方向:502 与 504 的区别(上游返回无效响应 vs 上游超时没响应)、401 与 403 的区别(没登录 vs 没权限)、301/302/307/308 的方法保留语义差异。
写接口文档、网关路由与监控告警规则时可直接对照本表选码:业务校验失败推荐 422 而不是 400、限流必须是 429 且带 Retry-After、异步任务受理用 202 表达「已排队」。
常见问题
502 Bad Gateway:网关/代理收到了上游的无效响应——上游进程崩了或返回格式错;503 Service Unavailable:服务明确表示暂不可用(过载、维护),通常带 Retry-After;504 Gateway Timeout:上游在时限内根本没响应——慢查询、死循环的典型信号。排查顺序:先看 504 查上游耗时,再看 502 查上游进程日志。