HTTP 状态码:完整参考
每个 HTTP 响应都带有一个三位数状态码,告诉客户端请求的结果如何。第一位数字确定类别,所以即使是你从没见过的代码也能一眼读出意图。这是完整、可搜索的列表。
- 1xx — 信息:请求已收到,继续处理。
- 2xx — 成功:请求已收到并被接受。
- 3xx — 重定向:需要进一步动作才能完成。
- 4xx — 客户端错误:请求存在问题。
- 5xx — 服务器错误:服务器未能完成有效请求。
更新 2026-07-06
| 代码 | 名称 | 含义 |
|---|---|---|
| 100 | Continue | 已收到请求的开头部分;客户端应继续发送正文。 |
| 101 | Switching Protocols | 服务器同意按客户端请求切换协议(例如切换到 WebSocket)。 |
| 102 | Processing | 服务器已收到并正在处理请求,但尚无响应可用(WebDAV)。 |
| 103 | Early Hints | 在最终响应之前发送的预加载提示,使浏览器可提前获取资源。 |
| 200 | OK | 标准成功响应。含义取决于方法(GET 返回资源,POST 返回结果)。 |
| 201 | Created | 请求成功且创建了新资源,通常连同其位置返回。 |
| 202 | Accepted | 请求已被接受处理,但处理尚未完成。 |
| 203 | Non-Authoritative Information | 响应是转换代理修改后的版本,而非源站的。 |
| 204 | No Content | 请求成功但没有内容可返回。 |
| 205 | Reset Content | 成功;客户端应重置文档视图(例如清空表单)。 |
| 206 | Partial Content | 服务器仅传送资源的一部分,以响应 Range 头。 |
| 207 | Multi-Status | 为 WebDAV 传达关于多个资源的信息。 |
| 208 | Already Reported | 已枚举过的 WebDAV 绑定成员不再重复列出。 |
| 226 | IM Used | 服务器完成了 GET,响应表示已应用的实例操作。 |
| 300 | Multiple Choices | 请求有多个可能的响应;客户端可选择其一。 |
| 301 | Moved Permanently | 资源已永久移动到新 URL;请更新链接和书签。 |
| 302 | Found | 资源暂时位于另一个 URL;今后请求仍使用原 URL。 |
| 303 | See Other | 可在另一个 URL 找到响应,应以 GET 获取。 |
| 304 | Not Modified | 缓存版本仍然有效;客户端可重用(条件请求)。 |
| 307 | Temporary Redirect | 与 302 类似,但重定向时方法和正文不得改变。 |
| 308 | Permanent Redirect | 与 301 类似,但重定向时方法和正文不得改变。 |
| 400 | Bad Request | 由于客户端错误(语法错误、无效帧)服务器无法处理请求。 |
| 401 | Unauthorized | 需要身份验证,但验证失败或未提供。 |
| 402 | Payment Required | 保留供将来使用;API 偶尔用来表示计费问题。 |
| 403 | Forbidden | 服务器理解请求但拒绝授权。 |
| 404 | Not Found | 服务器找不到请求的资源。最常见的错误。 |
| 405 | Method Not Allowed | 此资源不支持该 HTTP 方法。 |
| 406 | Not Acceptable | 资源无法生成与请求 Accept 头匹配的内容。 |
| 407 | Proxy Authentication Required | 客户端必须先向代理进行身份验证。 |
| 408 | Request Timeout | 服务器等待请求超时。 |
| 409 | Conflict | 请求与资源当前状态冲突(例如编辑冲突)。 |
| 410 | Gone | 资源已永久消失且无已知的转发地址。 |
| 411 | Length Required | 请求必须指定 Content-Length 头。 |
| 412 | Precondition Failed | 请求头中给定的前置条件求值为假。 |
| 413 | Payload Too Large | 请求正文大于服务器愿意处理的大小。 |
| 414 | URI Too Long | 请求的 URL 长于服务器将解释的长度。 |
| 415 | Unsupported Media Type | 该资源不支持请求的媒体类型。 |
| 416 | Range Not Satisfiable | 无法满足所请求的 Range。 |
| 417 | Expectation Failed | 无法满足 Expect 头中的期望。 |
| 418 | I'm a teapot | 愚人节玩笑代码(RFC 2324);服务器拒绝冲泡咖啡。 |
| 421 | Misdirected Request | 请求被定向到无法产生响应的服务器。 |
| 422 | Unprocessable Content | 请求格式正确但语义无效(API 验证错误中常见)。 |
| 423 | Locked | 正在访问的资源已被锁定(WebDAV)。 |
| 424 | Failed Dependency | 请求因其所依赖的前一个请求失败而失败(WebDAV)。 |
| 425 | Too Early | 服务器不愿冒险处理可能被重放的请求。 |
| 426 | Upgrade Required | 客户端应切换到 Upgrade 头中给定的其他协议。 |
| 428 | Precondition Required | 为防止更新丢失,源站要求请求为条件请求。 |
| 429 | Too Many Requests | 客户端在给定时间内发送了太多请求(限流)。 |
| 431 | Request Header Fields Too Large | 请求头过大,服务器无法处理。 |
| 451 | Unavailable For Legal Reasons | 由于法律要求(审查、下架)资源不可用。 |
| 500 | Internal Server Error | 通用错误;服务器遇到意外情况。服务器端的万能故障。 |
| 501 | Not Implemented | 服务器不支持完成请求所需的功能。 |
| 502 | Bad Gateway | 作为网关的服务器从上游服务器收到无效响应。 |
| 503 | Service Unavailable | 服务器暂时无法处理请求(过载或停机维护)。 |
| 504 | Gateway Timeout | 网关服务器未及时从上游服务器获得响应。 |
| 505 | HTTP Version Not Supported | 服务器不支持请求中使用的 HTTP 版本。 |
| 506 | Variant Also Negotiates | 服务器的内容协商配置错误。 |
| 507 | Insufficient Storage | 服务器无法存储完成请求所需的表示(WebDAV)。 |
| 508 | Loop Detected | 服务器在处理请求时检测到无限循环(WebDAV)。 |
| 510 | Not Extended | 服务器需要对请求进行进一步扩展才能完成它。 |
| 511 | Network Authentication Required | 客户端必须进行身份验证以获得网络访问(强制门户)。 |
相关工具