跳到主要内容

HTTP 状态码速查表

状态码分类​

状态码范围类别描述
1xxInformational（信息性）请求已接收，继续处理
2xxSuccess（成功）请求成功处理
3xxRedirection（重定向）需要进一步操作以完成请求
4xxClient Error（客户端错误）客户端请求有错误
5xxServer Error（服务器错误）服务器处理请求失败

常用 HTTP 状态码详解​

1xx 信息性状态码​

状态码名称描述使用场景
100Continue客户端应继续发送请求大文件上传前确认
101Switching Protocols服务器同意切换协议WebSocket 升级
102Processing服务器正在处理请求WebDAV 扩展操作
103Early Hints预加载提示服务器提前返回部分头信息

2xx 成功状态码​

状态码名称描述使用场景
200OK请求成功正常页面访问
201Created资源创建成功POST 创建新资源
202Accepted请求已接受但未处理完成异步任务提交
203Non-Authoritative Information非权威信息代理修改了响应
204No Content无内容返回删除操作成功
205Reset Content重置内容表单提交后清空
206Partial Content部分内容断点续传、分片下载
207Multi-Status多状态响应WebDAV 多个操作结果
208Already Reported已报告WebDAV 绑定成员已报告
226IM Used实例操作已应用Delta encoding in HTTP

3xx 重定向状态码​

状态码名称描述使用场景
300Multiple Choices多种选择多个资源可用
301Moved Permanently永久重定向网站改版、域名变更
302Found临时重定向临时页面跳转
303See Other查看其他位置POST 后重定向到 GET
304Not Modified未修改缓存有效
305Use Proxy使用代理必须通过代理访问
307Temporary Redirect临时重定向保持请求方法不变
308Permanent Redirect永久重定向保持请求方法不变

4xx 客户端错误状态码​

状态码名称描述使用场景
400Bad Request错误请求请求语法错误
401Unauthorized未授权需要身份验证
402Payment Required需要付款保留状态码
403Forbidden禁止访问无权限访问资源
404Not Found未找到资源不存在
405Method Not Allowed方法不允许请求方法不支持
406Not Acceptable不可接受无法满足 Accept 头
407Proxy Authentication Required需要代理认证代理服务器需要认证
408Request Timeout请求超时服务器等待请求超时
409Conflict冲突资源状态冲突
410Gone已删除资源永久删除
411Length Required需要长度需要 Content-Length
412Precondition Failed先决条件失败If-Match 等条件失败
413Payload Too Large负载过大请求体过大
414URI Too LongURI过长请求URI过长
415Unsupported Media Type不支持的媒体类型Content-Type 不支持
416Range Not Satisfiable范围不符合要求请求范围无效
417Expectation Failed期望失败Expect 头无法满足
418I'm a teapot我是茶壶愚人节玩笑
421Misdirected Request错误定向请求服务器无法产生响应
422Unprocessable Entity不可处理的实体WebDAV 语义错误
423Locked已锁定WebDAV 资源锁定
424Failed Dependency依赖失败WebDAV 依赖操作失败
425Too Early太早重复请求风险
426Upgrade Required需要升级需要更高版本协议
428Precondition Required需要先决条件需要条件请求
429Too Many Requests请求过多速率限制
431Request Header Fields Too Large请求头字段太大请求头过大
451Unavailable For Legal Reasons因法律原因不可用法律审查

5xx 服务器错误状态码​

状态码名称描述使用场景
500Internal Server Error服务器内部错误服务器代码错误
501Not Implemented未实现请求方法未实现
502Bad Gateway错误网关上游服务器无效响应
503Service Unavailable服务不可用服务器过载或维护
504Gateway Timeout网关超时上游服务器响应超时
505HTTP Version Not SupportedHTTP版本不支持不支持的HTTP版本
506Variant Also Negotiates变体协商透明内容协商错误
507Insufficient Storage存储空间不足WebDAV 磁盘空间不足
508Loop Detected检测到循环WebDAV 无限循环
510Not Extended未扩展需要扩展请求
511Network Authentication Required需要网络认证需要网络访问认证

常用状态码速查​

状态码名称频率处理建议
200OK⭐⭐⭐⭐⭐正常处理
301Moved Permanently⭐⭐⭐⭐更新书签和链接
302Found⭐⭐⭐⭐临时跳转
304Not Modified⭐⭐⭐⭐使用缓存
400Bad Request⭐⭐⭐⭐检查请求格式
401Unauthorized⭐⭐⭐提供认证信息
403Forbidden⭐⭐⭐检查权限
404Not Found⭐⭐⭐⭐⭐检查URL或重定向
500Internal Server Error⭐⭐⭐⭐服务器端排查
502Bad Gateway⭐⭐⭐检查上游服务
503Service Unavailable⭐⭐⭐重试或等待恢复
504Gateway Timeout⭐⭐检查网络或服务超时

开发调试技巧​

# 使用 curl 查看状态码
curl -s -o /dev/null -w "%{http_code}" https://example.com

# 查看详细响应头
curl -I https://example.com

# 测试重定向
curl -L https://example.com

# 自定义请求方法
curl -X POST https://api.example.com

# 带认证的请求
curl -u username:password https://api.example.com

监控建议​

  1. 重点关注：4xx 和 5xx 状态码比例
  2. 告警设置：5xx 状态码突然增加
  3. 性能指标：响应时间与状态码关联分析
  4. 用户体验：404 页面优化和重定向配置

最佳实践​

  1. 正确使用重定向：

    • 永久移动使用 301
    • 临时移动使用 302 或 307
    • POST 后重定向使用 303

  2. 错误处理：

    • 提供有意义的错误页面
    • 记录详细的错误日志
    • 返回机器可读的错误信息

  3. 缓存控制：

    • 正确使用 304 状态码
    • 设置合适的缓存头

💡 提示：完整的 HTTP 状态码列表请参考 IANA HTTP Status Code Registry