HTTP 状态码完整参考表
HTTP 状态码(HTTP Status Code)是服务器对客户端请求的响应状态标识,由 3 位数字组成,分为 5 大类。本表覆盖所有常用状态码,包含中英文名称和详细说明。
1xx 信息2xx 成功3xx 重定向4xx 客户端错误5xx 服务器错误
| 状态码 | 英文名称 | 中文名称 | 分类 | 说明 |
|---|---|---|---|---|
| 100 | Continue | 继续 | 1xx 信息 | 客户端应继续发送请求体。 |
| 101 | Switching Protocols | 切换协议 | 1xx 信息 | 服务器同意切换协议(如升级到 WebSocket)。 |
| 102 | Processing | 处理中 | 1xx 信息 | 服务器已收到请求,仍在处理中。 |
| 200 | OK | 成功 | 2xx 成功 | 请求成功。最常见的状态码。 |
| 201 | Created | 已创建 | 2xx 成功 | 请求成功并创建了新资源(POST 请求常见)。 |
| 202 | Accepted | 已接受 | 2xx 成功 | 请求已接受但尚未处理完成(异步任务)。 |
| 204 | No Content | 无内容 | 2xx 成功 | 请求成功但无内容返回(DELETE 请求常见)。 |
| 206 | Partial Content | 部分内容 | 2xx 成功 | 服务器返回部分内容(Range 请求)。 |
| 301 | Moved Permanently | 永久重定向 | 3xx 重定向 | 资源已永久移动到新 URL。SEO 权重传递。 |
| 302 | Found | 临时重定向 | 3xx 重定向 | 资源临时移动到新 URL。不传递 SEO 权重。 |
| 304 | Not Modified | 未修改 | 3xx 重定向 | 资源未修改,客户端应使用缓存版本。 |
| 307 | Temporary Redirect | 临时重定向(保持方法) | 3xx 重定向 | 临时重定向,保持原始请求方法。 |
| 308 | Permanent Redirect | 永久重定向(保持方法) | 3xx 重定向 | 永久重定向,保持原始请求方法。 |
| 400 | Bad Request | 请求错误 | 4xx 客户端错误 | 请求语法错误或参数无效。 |
| 401 | Unauthorized | 未授权 | 4xx 客户端错误 | 需要身份验证。常见于缺少或无效的 Token。 |
| 403 | Forbidden | 禁止访问 | 4xx 客户端错误 | 服务器拒绝请求(权限不足)。 |
| 404 | Not Found | 未找到 | 4xx 客户端错误 | 请求的资源不存在。最常见的客户端错误。 |
| 405 | Method Not Allowed | 方法不允许 | 4xx 客户端错误 | 请求方法不被允许(如对只支持 GET 的接口发 POST)。 |
| 408 | Request Timeout | 请求超时 | 4xx 客户端错误 | 客户端未在服务器超时时间内发送请求。 |
| 409 | Conflict | 冲突 | 4xx 客户端错误 | 请求与服务器当前状态冲突(如重复创建)。 |
| 410 | Gone | 已删除 | 4xx 客户端错误 | 资源已永久删除(比 404 更明确)。 |
| 413 | Payload Too Large | 请求体过大 | 4xx 客户端错误 | 请求体超过服务器限制(如上传文件过大)。 |
| 415 | Unsupported Media Type | 不支持的媒体类型 | 4xx 客户端错误 | 请求的 Content-Type 不被服务器支持。 |
| 422 | Unprocessable Entity | 无法处理的实体 | 4xx 客户端错误 | 请求格式正确但语义错误(如字段验证失败)。 |
| 429 | Too Many Requests | 请求过多 | 4xx 客户端错误 | 请求频率超过限制(限流)。 |
| 500 | Internal Server Error | 服务器内部错误 | 5xx 服务器错误 | 服务器遇到意外错误。最常见的服务器错误。 |
| 501 | Not Implemented | 未实现 | 5xx 服务器错误 | 服务器不支持请求的功能。 |
| 502 | Bad Gateway | 网关错误 | 5xx 服务器错误 | 网关/代理从上游服务器收到无效响应。 |
| 503 | Service Unavailable | 服务不可用 | 5xx 服务器错误 | 服务暂时不可用(过载或维护中)。 |
| 504 | Gateway Timeout | 网关超时 | 5xx 服务器错误 | 网关/代理等待上游服务器超时。 |
| 511 | Network Authentication Required | 需要网络认证 | 5xx 服务器错误 | 需要网络认证(如公共 WiFi 登录页)。 |