什么是HTTP 状态码查询？
HTTP 状态代码是 Web 服务器在每次响应中返回的三位数字，用于告知客户端（浏览器、应用或 API 调用方）请求是成功、需要重定向还是失败 — 以及原因。它们由 IETF 标准化，并在所有 Web 服务器、浏览器和编程语言中以相同方式使用，这使它们成为软件开发中最通用的调试参考资料之一。
此查询工具涵盖了全部五类中最常见的代码 — 信息性（1xx）、成功（2xx）、重定向（3xx）、客户端错误（4xx）和服务器错误（5xx）— 用通俗易懂的语言解释每个代码在实践中真正意味着什么，而不仅仅是 RFC 的正式定义。
何时使用此计算器
- 调试 API 集成时请求失败，需要了解状态代码的实际含义
- 决定针对特定错误条件，应从自己的 API 返回哪个 HTTP 状态代码
- 在 Web 开发课程或训练营中教授或学习 HTTP 基础知识
- 编写需要区分不同 4xx 和 5xx 情况的错误处理中间件
- 通过检查返回的是 301 还是 302，调查重定向不起作用的原因
- 排查 CORS 问题，浏览器显示网络错误但服务器返回了 200
步骤:
- 在搜索框中输入状态代码（如 404）或关键字（如“forbidden”）。
- 如果想浏览特定范围，可使用 1xx-5xx 按钮按类别筛选。
- 阅读关于该代码含义以及通常在何时返回的通俗解释。
- 在调试 API 响应或构建错误处理时，将此作为快速参考资料。
公式
1xx：信息性 — 已收到请求，处理中
2xx：成功 — 请求已成功接收并接受
3xx：重定向 — 需要进一步操作才能完成请求
4xx：客户端错误 — 请求包含错误的语法或无法完成
5xx：服务器错误 — 服务器未能完成一个有效请求
使用场景
- 快速理解您正在集成的 API 返回的一个陌生状态代码
- 决定针对特定错误条件，应从自己的 API 返回哪个状态代码
- 通过检查某个特定代码的实际含义来调试请求失败的原因
- 在 Web 开发课程中教授或学习 HTTP 基础知识
- 编写能够区分不同 4xx 和 5xx 情况的精确错误处理逻辑
主要优势
- 所有常用状态代码汇集在一个可搜索的参考资料中
- 通俗易懂的解释，而不仅仅是正式的 RFC 措辞
- 按类别即时筛选（1xx 到 5xx）
- 免费、快速、无需注册
专业提示
- 严格将 5xx 代码保留给服务器端故障 — 切勿用它们来提示客户端输入错误
- 限流时使用带 Retry-After 头的 429，让行为良好的客户端知道何时重试
- 当资源确实不存在时，优先返回 404 而不是通用错误页面 — 这对用户和搜索引擎都更好
- 设计 API 时，选择具体的 4xx 代码（422、409、400），而不是把所有情况都默认为通用的 400
需要避免的常见错误
- 对实际失败的请求返回 200 OK，向监控工具隐藏了错误
- 混淆 401（未认证）和 403（已认证但未授权）
- 对应当永久（301）的重定向使用 302，损害 SEO
- 在客户端错误处理中把 4xx 和 5xx 错误一视同仁，而不是根据具体代码进行分支处理
关键术语解释
- 状态行：HTTP 响应的第一行，包含状态代码和简短的原因短语
- 幂等：某些 HTTP 方法的一种属性，重复相同请求的效果与执行一次相同
- 重定向链：浏览器在到达最终资源之前遵循的一系列重定向
- 速率限制：限制客户端在给定时间窗口内可以发送的请求数量，通常以 429 表示
相关概念
- JSON 格式化工具:
- JSON 验证工具:
- 正则表达式测试工具:
- URL 编码/解码器:
- Base64 编码/解码器:
示例
搜索“429”会返回“Too Many Requests”（请求过多）— 当您超出速率限制时 API 返回的代码，提示您放慢速度并在延迟后重试。
解读您的结果
HTTP 状态代码按第一位数字分为五类。1xx 属于信息性响应，在应用代码中很少见到。2xx 确认成功 — 200 OK 最常见，但 201 已创建和 204 无内容在 REST API 中也很常见。3xx 处理重定向，其中 301（永久）和 302（临时）最为重要。
4xx 错误表示客户端的请求有问题。最常见的是 400 错误请求（语法格式错误）、401 未授权（未认证）、403 禁止访问（未授权）、404 未找到（资源不存在）和 429 请求过多（超出速率限制）。正确使用具体的 4xx 代码会让您的 API 比一律返回通用 400 更易于调试。
5xx 错误意味着服务器发生故障。500 是通用的内部错误，502 网关错误表示上游服务器有问题，503 服务不可用通常意味着服务器过载或停机维护。调试 5xx 错误时，应检查服务器日志而不是客户端响应，因为仅凭状态代码很少能揭示根本原因。