HTTP状态码查询器
完整的HTTP状态码数据库(1xx-5xx),智能搜索和分类浏览,详细说明、使用场景、典型错误原因
Continue
信息响应客户端应继续发送请求的剩余部分。通常用于客户端发送带有大量数据的POST请求时
使用场景
- •POST请求上传大文件前的验证
- •客户端发送Expect: 100-continue头部
排查建议
- ✓确保客户端支持100-continue机制
- ✓检查服务器是否正确响应Expect头部
RFC参考:RFC 7231, Section 6.2.1
Switching Protocols
信息响应服务器正在切换协议,例如从HTTP切换到WebSocket
使用场景
- •WebSocket握手成功
- •HTTP/1.1升级到HTTP/2
排查建议
- ✓验证Upgrade头部是否正确
- ✓检查目标协议是否被服务器支持
RFC参考:RFC 7231, Section 6.2.2
Processing
信息响应服务器已收到并正在处理请求,但还没有响应可用(WebDAV)
使用场景
- •WebDAV长时间复制操作
- •复杂的服务器端计算
排查建议
- ✓检查服务器是否支持WebDAV
- ✓确认操作是否真的需要长时间处理
RFC参考:RFC 2518
Early Hints
信息响应用于在最终响应前返回资源预加载提示,提升性能
使用场景
- •Link: </style.css>; rel=preload; as=style
- •预加载关键CSS和JS资源
排查建议
- ✓确保浏览器支持103状态码
- ✓验证Link头部格式正确
RFC参考:RFC 8297
OK
成功响应请求成功。这是最常见的HTTP状态码,表示标准的成功响应
使用场景
- •GET请求成功获取资源
- •POST请求成功处理表单数据
排查建议
- ✓如果响应体为空,检查服务器逻辑
- ✓验证返回的Content-Type是否正确
RFC参考:RFC 7231, Section 6.3.1
Created
成功响应请求成功并创建了新资源。通常在POST或PUT请求后返回
使用场景
- •POST /api/users 创建新用户成功
- •响应头包含Location: /users/123
排查建议
- ✓确保响应头包含Location指向新资源
- ✓检查资源是否真的被创建
RFC参考:RFC 7231, Section 6.3.2
Accepted
成功响应请求已接受但尚未处理。常用于异步处理场景
使用场景
- •异步队列任务已提交
- •批量导入数据请求已接收
排查建议
- ✓提供任务状态查询接口
- ✓确保客户端知道这是异步操作
RFC参考:RFC 7231, Section 6.3.3
Non-Authoritative Information
成功响应请求成功,但返回的元信息来自第三方或缓存,而非源服务器
使用场景
- •代理服务器修改了响应头
- •CDN返回的缓存内容
排查建议
- ✓检查代理配置是否正确
- ✓验证缓存策略是否符合预期
RFC参考:RFC 7231, Section 6.3.4
No Content
成功响应请求成功但无内容返回。常用于DELETE请求或不需要返回数据的更新操作
使用场景
- •DELETE /api/users/123 删除成功
- •PUT /api/settings 更新成功但无返回
排查建议
- ✓确保响应体真的为空
- ✓检查Content-Length: 0是否正确设置
RFC参考:RFC 7231, Section 6.3.5
Reset Content
成功响应请求成功,服务器要求客户端重置文档视图(如清空表单)
使用场景
- •表单提交成功后清空表单
- •重置数据录入界面
排查建议
- ✓确保客户端实现了重置逻辑
- ✓检查是否适合使用204而非205
RFC参考:RFC 7231, Section 6.3.6
Partial Content
成功响应服务器成功处理了部分GET请求。用于断点续传和流媒体
使用场景
- •Range: bytes=0-1023 请求成功
- •视频播放的分块加载
排查建议
- ✓检查Range头部格式是否正确
- ✓验证Content-Range响应头
- ✓确保服务器支持范围请求
RFC参考:RFC 7233, Section 4.1
Multi-Status
成功响应WebDAV多状态响应,包含多个独立操作的结果
使用场景
- •PROPFIND返回多个资源状态
- •批量文件操作结果
排查建议
- ✓检查响应体XML格式
- ✓验证每个子操作的状态码
RFC参考:RFC 4918
Already Reported
成功响应WebDAV绑定成员已在前面的响应中列出,不再重复(避免循环)
使用场景
- •PROPFIND避免重复返回绑定资源
- •WebDAV集合遍历优化
排查建议
- ✓检查DAV:propstat元素
- ✓确认绑定关系是否正确
RFC参考:RFC 5842
IM Used
成功响应服务器已完成GET请求,响应是一个或多个实例操作应用于当前实例的结果
使用场景
- •Delta编码传输
- •HTTP增量编码
排查建议
- ✓检查IM头部配置
- ✓验证增量编码实现
RFC参考:RFC 3229
Multiple Choices
重定向请求有多个可选响应。用户代理或用户应选择其中之一
使用场景
- •多语言版本选择
- •多格式资源(JSON/XML/HTML)
排查建议
- ✓提供清晰的选择列表
- ✓考虑使用内容协商(Accept头)
RFC参考:RFC 7231, Section 6.4.1
Moved Permanently
重定向资源已永久移动到新位置。搜索引擎会更新索引
使用场景
- •网站域名变更
- •HTTP升级到HTTPS
- •旧API版本迁移到新版本
排查建议
- ✓确保Location头部包含完整的新URL
- ✓检查重定向链长度(避免超过5次)
- ✓验证新URL是否可访问
RFC参考:RFC 7231, Section 6.4.2
Found
重定向资源临时移动到新位置。客户端应继续使用原URL访问
使用场景
- •临时维护页面
- •A/B测试重定向
- •短期活动页面跳转
排查建议
- ✓确认是否真的需要临时重定向(vs 301)
- ✓检查浏览器是否正确处理POST重定向
- ✓验证Location头部正确性
RFC参考:RFC 7231, Section 6.4.3
See Other
重定向POST/PUT/DELETE后重定向到GET请求。常用于表单提交后的页面跳转
使用场景
- •表单提交后跳转到结果页
- •POST-Redirect-GET模式
排查建议
- ✓确保客户端将POST转为GET
- ✓验证目标URL返回200响应
RFC参考:RFC 7231, Section 6.4.4
Not Modified
重定向资源未修改,客户端可使用缓存版本。用于条件GET请求
使用场景
- •If-None-Match与ETag匹配
- •If-Modified-Since检查未更新
排查建议
- ✓检查ETag或Last-Modified头部
- ✓确保服务器正确处理条件请求
- ✓验证缓存策略配置
RFC参考:RFC 7232, Section 4.1
Use Proxy
重定向已废弃。请求必须通过代理访问(已弃用,不推荐使用)
使用场景
- •(已废弃,现代浏览器不支持)
排查建议
- ✓避免使用此状态码
- ✓使用其他重定向方式
RFC参考:RFC 7231, Section 6.4.5
Temporary Redirect
重定向临时重定向,客户端应使用相同方法访问新URL(保持POST/GET不变)
使用场景
- •临时服务器维护
- •负载均衡临时调整
排查建议
- ✓确保请求方法不改变
- ✓与302对比,选择合适的状态码
RFC参考:RFC 7231, Section 6.4.7
Permanent Redirect
重定向永久重定向,客户端应使用相同方法访问新URL(保持POST/GET不变)
使用场景
- •API版本升级(v1 → v2)
- •POST请求永久迁移
排查建议
- ✓确保新URL支持相同的HTTP方法
- ✓与301对比,选择合适的状态码
RFC参考:RFC 7538
Bad Request
客户端错误请求语法错误或参数无效。服务器无法理解请求
使用场景
- •JSON格式错误
- •缺少必需参数
- •参数类型不匹配
排查建议
- ✓检查请求体格式(JSON/XML)
- ✓验证所有必需参数已提供
- ✓确认参数类型和值范围
- ✓查看服务器错误日志获取详细信息
RFC参考:RFC 7231, Section 6.5.1
Unauthorized
客户端错误未认证。请求需要用户身份验证
使用场景
- •缺少Authorization头部
- •Token过期或无效
- •用户名密码错误
排查建议
- ✓检查Authorization头部是否正确
- ✓验证Token是否过期
- ✓确认认证方案(Basic/Bearer/Digest)
- ✓查看WWW-Authenticate响应头
RFC参考:RFC 7235, Section 3.1
Payment Required
客户端错误保留状态码,用于未来的支付系统(实验性)
使用场景
- •付费API调用
- •数字内容付费
排查建议
- ✓使用自定义业务逻辑处理付费
- ✓考虑使用402或自定义4xx状态码
RFC参考:RFC 7231, Section 6.5.2
Forbidden
客户端错误已认证但无权限访问。服务器理解请求但拒绝执行
使用场景
- •用户无资源访问权限
- •IP地址被封禁
- •文件权限不足
排查建议
- ✓检查用户角色和权限配置
- ✓验证资源的访问控制列表(ACL)
- ✓确认IP白名单/黑名单
- ✓查看CORS配置(跨域场景)
RFC参考:RFC 7231, Section 6.5.3
Not Found
客户端错误资源不存在。服务器找不到请求的资源
使用场景
- •URL路径拼写错误
- •资源已被删除
- •路由配置错误
排查建议
- ✓检查URL拼写和大小写
- ✓验证路由配置
- ✓确认资源是否真的存在
- ✓查看服务器错误日志
RFC参考:RFC 7231, Section 6.5.4
Method Not Allowed
客户端错误HTTP方法不被允许。请求方法不适用于该资源
使用场景
- •对只读资源使用POST
- •DELETE方法未实现
- •OPTIONS预检请求失败
排查建议
- ✓检查Allow响应头列出的允许方法
- ✓验证API文档中的方法支持
- ✓确认服务器路由配置
RFC参考:RFC 7231, Section 6.5.5
Not Acceptable
客户端错误无法根据Accept头提供合适的内容格式
使用场景
- •请求application/xml但只支持JSON
- •Accept-Language不匹配
排查建议
- ✓检查Accept头部值
- ✓验证服务器支持的Content-Type
- ✓使用通配符Accept: */*测试
RFC参考:RFC 7231, Section 6.5.6
Proxy Authentication Required
客户端错误需要代理服务器认证
使用场景
- •企业代理需要账号密码
- •Proxy-Authorization头缺失
排查建议
- ✓检查Proxy-Authorization头部
- ✓验证代理服务器配置
- ✓确认代理凭据是否正确
RFC参考:RFC 7235, Section 3.2
Request Timeout
客户端错误服务器等待客户端请求超时
使用场景
- •客户端发送数据过慢
- •网络连接不稳定
排查建议
- ✓增加服务器超时时间
- ✓检查网络连接质量
- ✓优化客户端请求发送速度
RFC参考:RFC 7231, Section 6.5.7
Conflict
客户端错误请求与服务器当前状态冲突
使用场景
- •并发修改冲突
- •重复创建资源
- •数据版本冲突
排查建议
- ✓实现乐观锁(版本号)
- ✓检查资源是否已存在
- ✓使用幂等性设计避免冲突
RFC参考:RFC 7231, Section 6.5.8
Gone
客户端错误资源已永久删除且不会再提供
使用场景
- •旧版API已下线
- •过期内容已移除
排查建议
- ✓与404对比,410表示明确删除
- ✓提供替代资源的链接
- ✓更新客户端代码移除旧引用
RFC参考:RFC 7231, Section 6.5.9
Length Required
客户端错误服务器要求请求包含Content-Length头部
使用场景
- •POST请求缺少Content-Length
- •分块传输不被支持
排查建议
- ✓添加Content-Length头部
- ✓检查服务器是否支持Transfer-Encoding: chunked
RFC参考:RFC 7231, Section 6.5.10
Precondition Failed
客户端错误前置条件失败。If-Match或If-Unmodified-Since检查未通过
使用场景
- •If-Match ETag不匹配
- •资源已被修改(乐观锁失败)
排查建议
- ✓重新获取资源的最新ETag
- ✓检查If-Match条件是否正确
- ✓实现冲突解决机制
RFC参考:RFC 7232, Section 4.2
Payload Too Large
客户端错误请求体过大。服务器拒绝处理超出限制的请求
使用场景
- •上传文件超出大小限制
- •POST数据过大
排查建议
- ✓检查服务器配置的最大请求体大小
- ✓分块上传大文件
- ✓压缩请求数据
RFC参考:RFC 7231, Section 6.5.11
URI Too Long
客户端错误URI过长。服务器拒绝处理过长的URL
使用场景
- •GET请求参数过多
- •超长查询字符串
排查建议
- ✓改用POST传递参数
- ✓缩短URL长度
- ✓检查服务器URI长度限制配置
RFC参考:RFC 7231, Section 6.5.12
Unsupported Media Type
客户端错误不支持的媒体类型。服务器拒绝处理该Content-Type
使用场景
- •发送XML但服务器只接受JSON
- •Content-Type头部错误
排查建议
- ✓检查Content-Type头部
- ✓验证服务器支持的媒体类型
- ✓确认请求体格式正确
RFC参考:RFC 7231, Section 6.5.13
Range Not Satisfiable
客户端错误请求的Range范围无效或超出资源大小
使用场景
- •Range: bytes=1000-2000但文件只有500字节
- •范围格式错误
排查建议
- ✓检查Range头部格式
- ✓验证资源实际大小
- ✓查看Content-Range响应头
RFC参考:RFC 7233, Section 4.4
Expectation Failed
客户端错误Expect头部的要求无法满足
使用场景
- •Expect: 100-continue被拒绝
- •服务器不支持预期行为
排查建议
- ✓检查Expect头部值
- ✓确认服务器是否支持相关特性
RFC参考:RFC 7231, Section 6.5.14
I'm a teapot
客户端错误IETF愚人节玩笑(RFC 2324)。服务器拒绝煮咖啡因为它是茶壶
使用场景
- •HTCPCP协议(超文本咖啡壶控制协议)
- •彩蛋状态码
排查建议
- ✓这是个玩笑状态码,不应在生产环境使用
RFC参考:RFC 2324
Misdirected Request
客户端错误请求被定向到无法提供响应的服务器(HTTP/2)
使用场景
- •HTTP/2连接复用错误
- •SNI配置不匹配
排查建议
- ✓检查HTTP/2连接配置
- ✓验证服务器SNI设置
- ✓确认域名解析正确
RFC参考:RFC 7540, Section 9.1.2
Unprocessable Entity
客户端错误语法正确但语义错误。服务器理解请求但无法处理(WebDAV)
使用场景
- •数据验证失败
- •业务规则不满足
- •字段值不符合约束
排查建议
- ✓检查业务规则验证
- ✓查看详细的错误信息
- ✓验证所有字段约束
RFC参考:RFC 4918
Locked
客户端错误资源已被锁定(WebDAV)
使用场景
- •WebDAV文件编辑锁定
- •资源被其他用户占用
排查建议
- ✓等待锁释放
- ✓检查锁的超时时间
- ✓确认锁的所有者
RFC参考:RFC 4918
Failed Dependency
客户端错误因为前一个请求失败,当前请求也失败(WebDAV)
使用场景
- •PROPPATCH部分失败
- •批量操作依赖失败
排查建议
- ✓检查依赖请求的结果
- ✓修复前置操作的问题
RFC参考:RFC 4918
Too Early
客户端错误服务器拒绝处理可能被重放的请求(TLS Early Data)
使用场景
- •TLS 1.3 Early Data重放攻击防护
- •0-RTT数据被拒绝
排查建议
- ✓禁用Early Data
- ✓等待完整TLS握手完成
RFC参考:RFC 8470
Upgrade Required
客户端错误客户端需要升级协议
使用场景
- •强制升级到HTTPS
- •要求使用HTTP/2
排查建议
- ✓检查Upgrade头部要求
- ✓升级客户端协议支持
RFC参考:RFC 7231, Section 6.5.15
Precondition Required
客户端错误服务器要求请求是有条件的(需要If-Match等头部)
使用场景
- •防止"Lost Update"问题
- •强制乐观锁
排查建议
- ✓添加If-Match头部
- ✓使用ETag或Last-Modified
RFC参考:RFC 6585, Section 3
Too Many Requests
客户端错误请求频率过高。客户端发送了太多请求
使用场景
- •API速率限制
- •DDoS防护触发
排查建议
- ✓检查Retry-After头部
- ✓实现指数退避重试
- ✓降低请求频率
- ✓查看速率限制配置
RFC参考:RFC 6585, Section 4
Request Header Fields Too Large
客户端错误请求头字段过大
使用场景
- •Cookie过多或过大
- •Authorization头过长
排查建议
- ✓减少Cookie数量
- ✓压缩请求头
- ✓增加服务器头部大小限制
RFC参考:RFC 6585, Section 5
Unavailable For Legal Reasons
客户端错误因法律原因不可用(审查、版权等)
使用场景
- •DMCA版权投诉
- •地区内容审查
- •政府要求屏蔽
排查建议
- ✓检查地区限制
- ✓查看法律通知
- ✓使用VPN(如果合法)
RFC参考:RFC 7725
Internal Server Error
服务器错误服务器内部错误。服务器遇到意外情况无法完成请求
使用场景
- •代码异常未捕获
- •数据库连接失败
- •配置错误
排查建议
- ✓查看服务器错误日志
- ✓检查代码异常堆栈
- ✓验证数据库连接
- ✓确认配置文件正确
RFC参考:RFC 7231, Section 6.6.1
Not Implemented
服务器错误服务器不支持该请求方法或功能
使用场景
- •不支持的HTTP方法(如TRACE)
- •未实现的API功能
排查建议
- ✓检查服务器支持的方法
- ✓查看API文档确认功能支持
- ✓升级服务器软件版本
RFC参考:RFC 7231, Section 6.6.2
Bad Gateway
服务器错误网关错误。上游服务器返回无效响应
使用场景
- •Nginx无法连接后端服务
- •上游服务返回无效响应
- •代理配置错误
排查建议
- ✓检查上游服务器状态
- ✓验证代理配置
- ✓查看网关和上游服务器日志
- ✓确认网络连接正常
RFC参考:RFC 7231, Section 6.6.3
Service Unavailable
服务器错误服务不可用。服务器暂时无法处理请求(维护或过载)
使用场景
- •服务器维护中
- •服务器过载
- •数据库宕机
排查建议
- ✓检查Retry-After头部
- ✓等待维护完成
- ✓检查服务器负载
- ✓扩容服务器资源
RFC参考:RFC 7231, Section 6.6.4
Gateway Timeout
服务器错误网关超时。上游服务器未在规定时间内响应
使用场景
- •后端服务响应慢
- •数据库查询超时
- •网络延迟过高
排查建议
- ✓增加网关超时时间
- ✓优化上游服务性能
- ✓检查网络连接
- ✓查看上游服务日志
RFC参考:RFC 7231, Section 6.6.5
HTTP Version Not Supported
服务器错误不支持的HTTP版本
使用场景
- •客户端使用HTTP/0.9
- •服务器不支持HTTP/3
排查建议
- ✓升级服务器软件
- ✓降级客户端HTTP版本
- ✓检查协议协商
RFC参考:RFC 7231, Section 6.6.6
Variant Also Negotiates
服务器错误内容协商配置错误,导致循环引用
使用场景
- •TCN配置错误
- •透明内容协商失败
排查建议
- ✓检查TCN配置
- ✓修复内容协商循环
RFC参考:RFC 2295
Insufficient Storage
服务器错误存储空间不足(WebDAV)
使用场景
- •服务器磁盘空间满
- •配额超限
排查建议
- ✓清理磁盘空间
- ✓增加存储容量
- ✓检查配额设置
RFC参考:RFC 4918
Loop Detected
服务器错误检测到无限循环(WebDAV)
使用场景
- •WebDAV绑定循环
- •符号链接循环
排查建议
- ✓检查资源绑定关系
- ✓修复循环引用
RFC参考:RFC 5842
Not Extended
服务器错误需要进一步扩展请求
使用场景
- •HTTP扩展框架要求
- •策略不满足
排查建议
- ✓添加必需的扩展
- ✓检查扩展配置
RFC参考:RFC 2774
Network Authentication Required
服务器错误需要网络认证(如Wi-Fi登录页)
使用场景
- •酒店Wi-Fi登录页
- •公共网络认证门户
排查建议
- ✓完成网络认证
- ✓检查网络连接状态
RFC参考:RFC 6585, Section 6
快速导航
信息响应
4 个状态码
成功响应
10 个状态码
重定向
8 个状态码
客户端错误
29 个状态码
服务器错误
11 个状态码