HTTP常见状态码
更新时间:2025-03-31
状态码分类
HTTP 状态码分为五大类,涵盖从信息响应到服务器错误的完整流程:
- 1xx(信息响应):请求已接收,需继续处理。(#1xx 信息响应)
- 2xx(成功):请求被成功处理。(#2xx 成功)
- 3xx(重定向):需进一步操作(如跳转)完成请求。(#3xx 重定向)
- 4xx(客户端错误):请求语法错误或权限不足。(#4xx 客户端错误)
- 5xx(服务器错误):服务器处理请求失败。(#5xx 服务器错误)
1xx 信息响应
状态码 | 描述 | 场景示例 |
---|---|---|
100 | Continue | 客户端需继续发送请求体 |
101 | Switching Protocols | 协议切换(如升级至 WebSocket) |
102 | Processing | WebDAV 扩展,表示请求处理中 |
2xx 成功
状态码 | 描述 | 场景示例 |
---|---|---|
200 | OK | 请求成功(如网页加载或 API 返回数据) |
201 | Created | 资源创建成功(如用户注册) |
202 | Accepted | 请求已接受但未处理(异步操作) |
203 | Non-Authoritative | 非授权信息,服务成功处理,但信息来自另一来源 |
204 | No Content | 请求成功但无返回内容(如 DELETE 请求) |
205 | Reset Content | 重置内容,服务成功处理请求,无内容返回 |
206 | Partial Content | 部分内容响应(支持断点续传) |
207 | Multi-Status | WebDAV 多状态响应(XML 格式) |
208 | Already Reported | WebDAV 扩展,资源状态已报告 |
3xx 重定向
状态码 | 描述 | 场景示例 |
---|---|---|
301 | Moved Permanently | 资源永久重定向(需更新书签) |
302 | Found | 资源临时重定向(浏览器默认 GET) |
303 | See Other | 强制使用 GET 方法访问新 URI |
304 | Not Modified | 未修改,自上次请求后网页未修改 |
307 | Temporary Redirect | 临时重定向且保持原请求方法 |
308 | Permanent Redirect | 永久重定向且保持原请求方法 |
4xx 客户端错误
状态码 | 描述 | 场景示例 |
---|---|---|
400 | Bad Request | 请求语法错误(如 JSON 格式错误) |
401 | Unauthorized | 未认证(需登录或 Token) |
402 | Payment Required | 需付费访问(数字支付场景) |
403 | Forbidden | 无权限访问(如 IP 被拒) |
404 | Not Found | 资源不存在(路径错误或已删除) |
405 | Method Not Allowed | HTTP 方法不被支持(如禁用 POST) |
406 | Not Acceptable | 不接受,无法使用请求的内容特性响应请求的网页 |
408 | Request Timeout | 请求超时,服务器等候请求时发生超时 |
409 | Conflict | 冲突,服务器在完成请求时发生冲突 |
410 | Gone | 资源永久删除(需 301 重定向) |
429 | Too Many Requests | 请求频率过高(限流触发) |
451 | Unavailable For Legal Reasons | 因法律原因不可访问 |
子状态码扩展(以 IIS 为例):
- 401.1:登录失败(密码错误)
- 403.1:执行权限不足(如脚本目录权限)
- 404.1:端口访问被阻止
5xx 服务器错误
状态码 | 描述 | 场景示例 |
---|---|---|
500 | Internal Server Error | 通用服务器错误(代码异常或配置问题) |
501 | Not Implemented | 请求方法未实现(如不支持 PATCH) |
502 | Bad Gateway | 网关/代理服务器收到无效响应 |
503 | Service Unavailable | 服务不可用(过载或停机维护) |
504 | Gateway Timeout | 网关超时(上游服务器未响应) |
505 | HTTP Version Error | HTTP版本不受支持,服务器不支持请求的协议版本 |
507 | Insufficient Storage | 存储空间不足(WebDAV 场景) |
511 | Network Authentication Required | 需网络认证(如公共 Wi-Fi 登录) |
子状态码扩展(IIS 专用):
- 500.12:应用程序重启中
- 503.18:应用程序池配置错误
特殊状态码
状态码 | 描述 | 场景示例 |
---|---|---|
418 | I'm a teapot | 愚人节彩蛋(RFC 2324) |
499 | Client Closed Request | 客户端主动断开连接(Nginx 扩展) |
总结与建议
- 错误处理:
- 4xx 错误需检查客户端请求参数、权限和缓存策略。
- 5xx 错误需排查服务器日志、负载和依赖服务。
- 调试工具:使用浏览器开发者工具(Network 标签)实时查看状态码。