HTTP 状态码
HTTP 状态码速查表,含义与使用场景
共 59 个状态码
1xx 信息响应
| 状态码 | 名称 | 含义与使用场景 |
|---|---|---|
| 100 | Continue | 继续。客户端应继续发送请求的剩余部分 |
| 101 | Switching Protocols | 切换协议。服务器同意切换协议(如升级到 WebSocket) |
| 102 | Processing | 处理中。服务器已收到请求,正在处理(WebDAV) |
| 103 | Early Hints | 早期提示。用于在最终响应前预加载资源 |
2xx 成功
| 状态码 | 名称 | 含义与使用场景 |
|---|---|---|
| 200 | OK | 成功。请求已成功处理,响应体包含请求的数据 |
| 201 | Created | 已创建。资源已成功创建,常用于 POST 请求 |
| 202 | Accepted | 已接受。请求已接收但未处理完成(异步任务) |
| 203 | Non-Authoritative Information | 非权威信息。返回的信息来自第三方副本 |
| 204 | No Content | 无内容。成功但无响应体返回(如 DELETE 后) |
| 205 | Reset Content | 重置内容。要求客户端重置表单 |
| 206 | Partial Content | 部分内容。范围请求成功(断点续传) |
| 207 | Multi-Status | 多状态。XML 返回多个操作的独立状态(WebDAV) |
3xx 重定向
| 状态码 | 名称 | 含义与使用场景 |
|---|---|---|
| 300 | Multiple Choices | 多选。资源有多个表示,需选择其一 |
| 301 | Moved Permanently | 永久重定向。资源已永久迁移到新 URL |
| 302 | Found | 临时重定向。资源临时位于其他 URL |
| 303 | See Other | 查看其他。用 GET 访问另一个 URL 获取结果 |
| 304 | Not Modified | 未修改。缓存仍有效,无需重新下载 |
| 307 | Temporary Redirect | 临时重定向。保持原请求方法和 URL 不变 |
| 308 | Permanent Redirect | 永久重定向。保持请求方法的永久跳转 |
4xx 客户端错误
| 状态码 | 名称 | 含义与使用场景 |
|---|---|---|
| 400 | Bad Request | 请求错误。服务器无法理解请求格式 |
| 401 | Unauthorized | 未授权。需要身份验证才能访问 |
| 402 | Payment Required | 需要付款。保留用于将来付费机制 |
| 403 | Forbidden | 禁止访问。已认证但无权限访问该资源 |
| 404 | Not Found | 未找到。请求的资源不存在 |
| 405 | Method Not Allowed | 方法不允许。该 URL 不支持此 HTTP 方法 |
| 406 | Not Acceptable | 不可接受。无法生成客户端可接受的内容 |
| 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 | URI 过长。URL 超出服务器处理能力 |
| 415 | Unsupported Media Type | 不支持的媒体类型。Content-Type 不被接受 |
| 416 | Range Not Satisfiable | 范围无法满足。请求的 byte 范围无效 |
| 417 | Expectation Failed | 期望失败。Expect 头无法满足 |
| 418 | I'm a Teapot | 我是茶壶。愚人节彩蛋,不能用来泡咖啡 |
| 421 | Misdirected Request | 请求误导。请求发到了无法响应的服务器 |
| 422 | Unprocessable Entity | 不可处理实体。语法正确但语义错误(校验失败) |
| 423 | Locked | 已锁定。资源被锁定(WebDAV) |
| 424 | Failed Dependency | 依赖失败。依赖的请求失败(WebDAV) |
| 425 | Too Early | 过早。服务器不愿冒重放风险处理请求 |
| 426 | Upgrade Required | 需要升级。客户端需切换协议 |
| 428 | Precondition Required | 需要前置条件。要求提供 If-Match 等条件头 |
| 429 | Too Many Requests | 请求过多。触发限流,请稍后重试 |
| 431 | Request Header Fields Too Large | 请求头过大。头字段超出限制 |
| 451 | Unavailable For Legal Reasons | 因法律原因不可用。常用于内容审查 |
5xx 服务端错误
| 状态码 | 名称 | 含义与使用场景 |
|---|---|---|
| 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 | 需要网络认证。需登录网络(如公共 WiFi) |