HTTP状态码查询器

完整的HTTP状态码数据库(1xx-5xx),智能搜索和分类浏览,详细说明、使用场景、典型错误原因

找到 62 个状态码
100

Continue

信息响应

客户端应继续发送请求的剩余部分。通常用于客户端发送带有大量数据的POST请求时

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • POST请求上传大文件前的验证
  • 客户端发送Expect: 100-continue头部

排查建议

  • 确保客户端支持100-continue机制
  • 检查服务器是否正确响应Expect头部

RFC参考:RFC 7231, Section 6.2.1

101

Switching Protocols

信息响应

服务器正在切换协议,例如从HTTP切换到WebSocket

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • WebSocket握手成功
  • HTTP/1.1升级到HTTP/2

排查建议

  • 验证Upgrade头部是否正确
  • 检查目标协议是否被服务器支持

RFC参考:RFC 7231, Section 6.2.2

102

Processing

信息响应

服务器已收到并正在处理请求,但还没有响应可用(WebDAV)

支持协议:HTTP/1.1

使用场景

  • WebDAV长时间复制操作
  • 复杂的服务器端计算

排查建议

  • 检查服务器是否支持WebDAV
  • 确认操作是否真的需要长时间处理

RFC参考:RFC 2518

103

Early Hints

信息响应

用于在最终响应前返回资源预加载提示,提升性能

支持协议:HTTP/2, HTTP/3

使用场景

  • Link: </style.css>; rel=preload; as=style
  • 预加载关键CSS和JS资源

排查建议

  • 确保浏览器支持103状态码
  • 验证Link头部格式正确

RFC参考:RFC 8297

200

OK

成功响应

请求成功。这是最常见的HTTP状态码,表示标准的成功响应

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • GET请求成功获取资源
  • POST请求成功处理表单数据

排查建议

  • 如果响应体为空,检查服务器逻辑
  • 验证返回的Content-Type是否正确

RFC参考:RFC 7231, Section 6.3.1

201

Created

成功响应

请求成功并创建了新资源。通常在POST或PUT请求后返回

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • POST /api/users 创建新用户成功
  • 响应头包含Location: /users/123

排查建议

  • 确保响应头包含Location指向新资源
  • 检查资源是否真的被创建

RFC参考:RFC 7231, Section 6.3.2

202

Accepted

成功响应

请求已接受但尚未处理。常用于异步处理场景

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 异步队列任务已提交
  • 批量导入数据请求已接收

排查建议

  • 提供任务状态查询接口
  • 确保客户端知道这是异步操作

RFC参考:RFC 7231, Section 6.3.3

203

Non-Authoritative Information

成功响应

请求成功,但返回的元信息来自第三方或缓存,而非源服务器

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 代理服务器修改了响应头
  • CDN返回的缓存内容

排查建议

  • 检查代理配置是否正确
  • 验证缓存策略是否符合预期

RFC参考:RFC 7231, Section 6.3.4

204

No Content

成功响应

请求成功但无内容返回。常用于DELETE请求或不需要返回数据的更新操作

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • DELETE /api/users/123 删除成功
  • PUT /api/settings 更新成功但无返回

排查建议

  • 确保响应体真的为空
  • 检查Content-Length: 0是否正确设置

RFC参考:RFC 7231, Section 6.3.5

205

Reset Content

成功响应

请求成功,服务器要求客户端重置文档视图(如清空表单)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 表单提交成功后清空表单
  • 重置数据录入界面

排查建议

  • 确保客户端实现了重置逻辑
  • 检查是否适合使用204而非205

RFC参考:RFC 7231, Section 6.3.6

206

Partial Content

成功响应

服务器成功处理了部分GET请求。用于断点续传和流媒体

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • Range: bytes=0-1023 请求成功
  • 视频播放的分块加载

排查建议

  • 检查Range头部格式是否正确
  • 验证Content-Range响应头
  • 确保服务器支持范围请求

RFC参考:RFC 7233, Section 4.1

207

Multi-Status

成功响应

WebDAV多状态响应,包含多个独立操作的结果

支持协议:HTTP/1.1

使用场景

  • PROPFIND返回多个资源状态
  • 批量文件操作结果

排查建议

  • 检查响应体XML格式
  • 验证每个子操作的状态码

RFC参考:RFC 4918

208

Already Reported

成功响应

WebDAV绑定成员已在前面的响应中列出,不再重复(避免循环)

支持协议:HTTP/1.1

使用场景

  • PROPFIND避免重复返回绑定资源
  • WebDAV集合遍历优化

排查建议

  • 检查DAV:propstat元素
  • 确认绑定关系是否正确

RFC参考:RFC 5842

226

IM Used

成功响应

服务器已完成GET请求,响应是一个或多个实例操作应用于当前实例的结果

支持协议:HTTP/1.1

使用场景

  • Delta编码传输
  • HTTP增量编码

排查建议

  • 检查IM头部配置
  • 验证增量编码实现

RFC参考:RFC 3229

300

Multiple Choices

重定向

请求有多个可选响应。用户代理或用户应选择其中之一

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 多语言版本选择
  • 多格式资源(JSON/XML/HTML)

排查建议

  • 提供清晰的选择列表
  • 考虑使用内容协商(Accept头)

RFC参考:RFC 7231, Section 6.4.1

301

Moved Permanently

重定向

资源已永久移动到新位置。搜索引擎会更新索引

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 网站域名变更
  • HTTP升级到HTTPS
  • 旧API版本迁移到新版本

排查建议

  • 确保Location头部包含完整的新URL
  • 检查重定向链长度(避免超过5次)
  • 验证新URL是否可访问

RFC参考:RFC 7231, Section 6.4.2

302

Found

重定向

资源临时移动到新位置。客户端应继续使用原URL访问

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 临时维护页面
  • A/B测试重定向
  • 短期活动页面跳转

排查建议

  • 确认是否真的需要临时重定向(vs 301)
  • 检查浏览器是否正确处理POST重定向
  • 验证Location头部正确性

RFC参考:RFC 7231, Section 6.4.3

303

See Other

重定向

POST/PUT/DELETE后重定向到GET请求。常用于表单提交后的页面跳转

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 表单提交后跳转到结果页
  • POST-Redirect-GET模式

排查建议

  • 确保客户端将POST转为GET
  • 验证目标URL返回200响应

RFC参考:RFC 7231, Section 6.4.4

304

Not Modified

重定向

资源未修改,客户端可使用缓存版本。用于条件GET请求

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • If-None-Match与ETag匹配
  • If-Modified-Since检查未更新

排查建议

  • 检查ETag或Last-Modified头部
  • 确保服务器正确处理条件请求
  • 验证缓存策略配置

RFC参考:RFC 7232, Section 4.1

305

Use Proxy

重定向

已废弃。请求必须通过代理访问(已弃用,不推荐使用)

支持协议:HTTP/1.1

使用场景

  • (已废弃,现代浏览器不支持)

排查建议

  • 避免使用此状态码
  • 使用其他重定向方式

RFC参考:RFC 7231, Section 6.4.5

307

Temporary Redirect

重定向

临时重定向,客户端应使用相同方法访问新URL(保持POST/GET不变)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 临时服务器维护
  • 负载均衡临时调整

排查建议

  • 确保请求方法不改变
  • 与302对比,选择合适的状态码

RFC参考:RFC 7231, Section 6.4.7

308

Permanent Redirect

重定向

永久重定向,客户端应使用相同方法访问新URL(保持POST/GET不变)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • API版本升级(v1 → v2)
  • POST请求永久迁移

排查建议

  • 确保新URL支持相同的HTTP方法
  • 与301对比,选择合适的状态码

RFC参考:RFC 7538

400

Bad Request

客户端错误

请求语法错误或参数无效。服务器无法理解请求

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • JSON格式错误
  • 缺少必需参数
  • 参数类型不匹配

排查建议

  • 检查请求体格式(JSON/XML)
  • 验证所有必需参数已提供
  • 确认参数类型和值范围
  • 查看服务器错误日志获取详细信息

RFC参考:RFC 7231, Section 6.5.1

401

Unauthorized

客户端错误

未认证。请求需要用户身份验证

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 缺少Authorization头部
  • Token过期或无效
  • 用户名密码错误

排查建议

  • 检查Authorization头部是否正确
  • 验证Token是否过期
  • 确认认证方案(Basic/Bearer/Digest)
  • 查看WWW-Authenticate响应头

RFC参考:RFC 7235, Section 3.1

402

Payment Required

客户端错误

保留状态码,用于未来的支付系统(实验性)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 付费API调用
  • 数字内容付费

排查建议

  • 使用自定义业务逻辑处理付费
  • 考虑使用402或自定义4xx状态码

RFC参考:RFC 7231, Section 6.5.2

403

Forbidden

客户端错误

已认证但无权限访问。服务器理解请求但拒绝执行

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 用户无资源访问权限
  • IP地址被封禁
  • 文件权限不足

排查建议

  • 检查用户角色和权限配置
  • 验证资源的访问控制列表(ACL)
  • 确认IP白名单/黑名单
  • 查看CORS配置(跨域场景)

RFC参考:RFC 7231, Section 6.5.3

404

Not Found

客户端错误

资源不存在。服务器找不到请求的资源

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • URL路径拼写错误
  • 资源已被删除
  • 路由配置错误

排查建议

  • 检查URL拼写和大小写
  • 验证路由配置
  • 确认资源是否真的存在
  • 查看服务器错误日志

RFC参考:RFC 7231, Section 6.5.4

405

Method Not Allowed

客户端错误

HTTP方法不被允许。请求方法不适用于该资源

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 对只读资源使用POST
  • DELETE方法未实现
  • OPTIONS预检请求失败

排查建议

  • 检查Allow响应头列出的允许方法
  • 验证API文档中的方法支持
  • 确认服务器路由配置

RFC参考:RFC 7231, Section 6.5.5

406

Not Acceptable

客户端错误

无法根据Accept头提供合适的内容格式

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 请求application/xml但只支持JSON
  • Accept-Language不匹配

排查建议

  • 检查Accept头部值
  • 验证服务器支持的Content-Type
  • 使用通配符Accept: */*测试

RFC参考:RFC 7231, Section 6.5.6

407

Proxy Authentication Required

客户端错误

需要代理服务器认证

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 企业代理需要账号密码
  • Proxy-Authorization头缺失

排查建议

  • 检查Proxy-Authorization头部
  • 验证代理服务器配置
  • 确认代理凭据是否正确

RFC参考:RFC 7235, Section 3.2

408

Request Timeout

客户端错误

服务器等待客户端请求超时

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 客户端发送数据过慢
  • 网络连接不稳定

排查建议

  • 增加服务器超时时间
  • 检查网络连接质量
  • 优化客户端请求发送速度

RFC参考:RFC 7231, Section 6.5.7

409

Conflict

客户端错误

请求与服务器当前状态冲突

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 并发修改冲突
  • 重复创建资源
  • 数据版本冲突

排查建议

  • 实现乐观锁(版本号)
  • 检查资源是否已存在
  • 使用幂等性设计避免冲突

RFC参考:RFC 7231, Section 6.5.8

410

Gone

客户端错误

资源已永久删除且不会再提供

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 旧版API已下线
  • 过期内容已移除

排查建议

  • 与404对比,410表示明确删除
  • 提供替代资源的链接
  • 更新客户端代码移除旧引用

RFC参考:RFC 7231, Section 6.5.9

411

Length Required

客户端错误

服务器要求请求包含Content-Length头部

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • POST请求缺少Content-Length
  • 分块传输不被支持

排查建议

  • 添加Content-Length头部
  • 检查服务器是否支持Transfer-Encoding: chunked

RFC参考:RFC 7231, Section 6.5.10

412

Precondition Failed

客户端错误

前置条件失败。If-Match或If-Unmodified-Since检查未通过

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • If-Match ETag不匹配
  • 资源已被修改(乐观锁失败)

排查建议

  • 重新获取资源的最新ETag
  • 检查If-Match条件是否正确
  • 实现冲突解决机制

RFC参考:RFC 7232, Section 4.2

413

Payload Too Large

客户端错误

请求体过大。服务器拒绝处理超出限制的请求

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 上传文件超出大小限制
  • POST数据过大

排查建议

  • 检查服务器配置的最大请求体大小
  • 分块上传大文件
  • 压缩请求数据

RFC参考:RFC 7231, Section 6.5.11

414

URI Too Long

客户端错误

URI过长。服务器拒绝处理过长的URL

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • GET请求参数过多
  • 超长查询字符串

排查建议

  • 改用POST传递参数
  • 缩短URL长度
  • 检查服务器URI长度限制配置

RFC参考:RFC 7231, Section 6.5.12

415

Unsupported Media Type

客户端错误

不支持的媒体类型。服务器拒绝处理该Content-Type

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 发送XML但服务器只接受JSON
  • Content-Type头部错误

排查建议

  • 检查Content-Type头部
  • 验证服务器支持的媒体类型
  • 确认请求体格式正确

RFC参考:RFC 7231, Section 6.5.13

416

Range Not Satisfiable

客户端错误

请求的Range范围无效或超出资源大小

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • Range: bytes=1000-2000但文件只有500字节
  • 范围格式错误

排查建议

  • 检查Range头部格式
  • 验证资源实际大小
  • 查看Content-Range响应头

RFC参考:RFC 7233, Section 4.4

417

Expectation Failed

客户端错误

Expect头部的要求无法满足

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • Expect: 100-continue被拒绝
  • 服务器不支持预期行为

排查建议

  • 检查Expect头部值
  • 确认服务器是否支持相关特性

RFC参考:RFC 7231, Section 6.5.14

418

I'm a teapot

客户端错误

IETF愚人节玩笑(RFC 2324)。服务器拒绝煮咖啡因为它是茶壶

支持协议:HTTP/1.1

使用场景

  • HTCPCP协议(超文本咖啡壶控制协议)
  • 彩蛋状态码

排查建议

  • 这是个玩笑状态码,不应在生产环境使用

RFC参考:RFC 2324

421

Misdirected Request

客户端错误

请求被定向到无法提供响应的服务器(HTTP/2)

支持协议:HTTP/2, HTTP/3

使用场景

  • HTTP/2连接复用错误
  • SNI配置不匹配

排查建议

  • 检查HTTP/2连接配置
  • 验证服务器SNI设置
  • 确认域名解析正确

RFC参考:RFC 7540, Section 9.1.2

422

Unprocessable Entity

客户端错误

语法正确但语义错误。服务器理解请求但无法处理(WebDAV)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 数据验证失败
  • 业务规则不满足
  • 字段值不符合约束

排查建议

  • 检查业务规则验证
  • 查看详细的错误信息
  • 验证所有字段约束

RFC参考:RFC 4918

423

Locked

客户端错误

资源已被锁定(WebDAV)

支持协议:HTTP/1.1

使用场景

  • WebDAV文件编辑锁定
  • 资源被其他用户占用

排查建议

  • 等待锁释放
  • 检查锁的超时时间
  • 确认锁的所有者

RFC参考:RFC 4918

424

Failed Dependency

客户端错误

因为前一个请求失败,当前请求也失败(WebDAV)

支持协议:HTTP/1.1

使用场景

  • PROPPATCH部分失败
  • 批量操作依赖失败

排查建议

  • 检查依赖请求的结果
  • 修复前置操作的问题

RFC参考:RFC 4918

425

Too Early

客户端错误

服务器拒绝处理可能被重放的请求(TLS Early Data)

支持协议:HTTP/2, HTTP/3

使用场景

  • TLS 1.3 Early Data重放攻击防护
  • 0-RTT数据被拒绝

排查建议

  • 禁用Early Data
  • 等待完整TLS握手完成

RFC参考:RFC 8470

426

Upgrade Required

客户端错误

客户端需要升级协议

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 强制升级到HTTPS
  • 要求使用HTTP/2

排查建议

  • 检查Upgrade头部要求
  • 升级客户端协议支持

RFC参考:RFC 7231, Section 6.5.15

428

Precondition Required

客户端错误

服务器要求请求是有条件的(需要If-Match等头部)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 防止"Lost Update"问题
  • 强制乐观锁

排查建议

  • 添加If-Match头部
  • 使用ETag或Last-Modified

RFC参考:RFC 6585, Section 3

429

Too Many Requests

客户端错误

请求频率过高。客户端发送了太多请求

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • API速率限制
  • DDoS防护触发

排查建议

  • 检查Retry-After头部
  • 实现指数退避重试
  • 降低请求频率
  • 查看速率限制配置

RFC参考:RFC 6585, Section 4

431

Request Header Fields Too Large

客户端错误

请求头字段过大

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • Cookie过多或过大
  • Authorization头过长

排查建议

  • 减少Cookie数量
  • 压缩请求头
  • 增加服务器头部大小限制

RFC参考:RFC 6585, Section 5

451

Unavailable For Legal Reasons

客户端错误

因法律原因不可用(审查、版权等)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • DMCA版权投诉
  • 地区内容审查
  • 政府要求屏蔽

排查建议

  • 检查地区限制
  • 查看法律通知
  • 使用VPN(如果合法)

RFC参考:RFC 7725

500

Internal Server Error

服务器错误

服务器内部错误。服务器遇到意外情况无法完成请求

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 代码异常未捕获
  • 数据库连接失败
  • 配置错误

排查建议

  • 查看服务器错误日志
  • 检查代码异常堆栈
  • 验证数据库连接
  • 确认配置文件正确

RFC参考:RFC 7231, Section 6.6.1

501

Not Implemented

服务器错误

服务器不支持该请求方法或功能

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 不支持的HTTP方法(如TRACE)
  • 未实现的API功能

排查建议

  • 检查服务器支持的方法
  • 查看API文档确认功能支持
  • 升级服务器软件版本

RFC参考:RFC 7231, Section 6.6.2

502

Bad Gateway

服务器错误

网关错误。上游服务器返回无效响应

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • Nginx无法连接后端服务
  • 上游服务返回无效响应
  • 代理配置错误

排查建议

  • 检查上游服务器状态
  • 验证代理配置
  • 查看网关和上游服务器日志
  • 确认网络连接正常

RFC参考:RFC 7231, Section 6.6.3

503

Service Unavailable

服务器错误

服务不可用。服务器暂时无法处理请求(维护或过载)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 服务器维护中
  • 服务器过载
  • 数据库宕机

排查建议

  • 检查Retry-After头部
  • 等待维护完成
  • 检查服务器负载
  • 扩容服务器资源

RFC参考:RFC 7231, Section 6.6.4

504

Gateway Timeout

服务器错误

网关超时。上游服务器未在规定时间内响应

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 后端服务响应慢
  • 数据库查询超时
  • 网络延迟过高

排查建议

  • 增加网关超时时间
  • 优化上游服务性能
  • 检查网络连接
  • 查看上游服务日志

RFC参考:RFC 7231, Section 6.6.5

505

HTTP Version Not Supported

服务器错误

不支持的HTTP版本

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 客户端使用HTTP/0.9
  • 服务器不支持HTTP/3

排查建议

  • 升级服务器软件
  • 降级客户端HTTP版本
  • 检查协议协商

RFC参考:RFC 7231, Section 6.6.6

506

Variant Also Negotiates

服务器错误

内容协商配置错误,导致循环引用

支持协议:HTTP/1.1

使用场景

  • TCN配置错误
  • 透明内容协商失败

排查建议

  • 检查TCN配置
  • 修复内容协商循环

RFC参考:RFC 2295

507

Insufficient Storage

服务器错误

存储空间不足(WebDAV)

支持协议:HTTP/1.1

使用场景

  • 服务器磁盘空间满
  • 配额超限

排查建议

  • 清理磁盘空间
  • 增加存储容量
  • 检查配额设置

RFC参考:RFC 4918

508

Loop Detected

服务器错误

检测到无限循环(WebDAV)

支持协议:HTTP/1.1

使用场景

  • WebDAV绑定循环
  • 符号链接循环

排查建议

  • 检查资源绑定关系
  • 修复循环引用

RFC参考:RFC 5842

510

Not Extended

服务器错误

需要进一步扩展请求

支持协议:HTTP/1.1

使用场景

  • HTTP扩展框架要求
  • 策略不满足

排查建议

  • 添加必需的扩展
  • 检查扩展配置

RFC参考:RFC 2774

511

Network Authentication Required

服务器错误

需要网络认证(如Wi-Fi登录页)

支持协议:HTTP/1.1, HTTP/2, HTTP/3

使用场景

  • 酒店Wi-Fi登录页
  • 公共网络认证门户

排查建议

  • 完成网络认证
  • 检查网络连接状态

RFC参考:RFC 6585, Section 6

快速导航

信息响应

4 个状态码

💬

成功响应

10 个状态码

重定向

8 个状态码

↪️

客户端错误

29 个状态码

⚠️

服务器错误

11 个状态码