HTTP 状态码是什么？

HTTP 状态码是由网络服务器返回的三位数字，用于响应客户端的请求。它们表示请求是否成功、被重定向或导致错误。理解这些代码对于网页开发、API 设计和调试至关重要。

状态码分类

HTTP 状态码根据首位数字分为五个类别：

1xx（信息性）

请求已被接收，服务器正在继续处理

2xx（成功）

请求已成功接收、理解并被接受

3xx（重定向）

需要进一步操作才能完成请求（通常是重定向）

4xx（客户端错误）

请求在客户端存在错误

5xx（服务器错误）

服务器无法完成有效请求

谁使用此工具？

此参考工具专为网页开发人员、API 开发人员、QA 测试人员和系统管理员设计，他们需要快速查找 HTTP 状态码、了解何时使用每个代码，以及比较类似的代码。

如何使用此工具

按分类浏览

所有 HTTP 状态码按分类（1xx 至 5xx）分组显示。每个分组都有独特的颜色便于识别。只需滚动列表即可浏览所有代码。

搜索状态码

使用顶部的搜索栏查找特定状态码。您可以按以下方式搜索：

状态码数字 — 输入"404"查找 404 Not Found
名称或关键词 — 输入"redirect"查找所有重定向相关代码
描述关键词 — 输入"proxy"查找提及代理服务器的代码

按分类筛选

点击分类标签（全部、1xx、2xx、3xx、4xx、5xx）仅显示特定分组中的代码。当您知道响应的大致类型但不知道确切代码时，这很有用。

查看详情

点击任何状态码卡片展开它，查看详细信息，包括：

使用场景 — 返回此代码的真实场景
常见请求头 — 通常与此代码关联的响应请求头
相关代码 — 用于比较的类似或常被混淆的代码

收藏您的最爱

点击任何代码上的收藏图标将其收藏。收藏的代码会显示在页面顶部以便快速访问。您的收藏保存在浏览器中，跨会话持久保存。

功能

完整的 HTTP 状态码参考

此工具涵盖 RFC 中定义的所有标准 HTTP 状态码，包括常用代码和不太常见的代码。

200 OK、301 Moved Permanently、404 Not Found
500 Internal Server Error
103 Early Hints、418 I'm a Teapot
451 Unavailable For Legal Reasons

颜色编码分类

每个分类都有自己的颜色方案，使您可以一目了然地识别响应类型。

信息性代码为蓝色
成功代码为绿色
重定向代码为琥珀色
客户端错误代码为红色
服务器错误代码为紫色

实用的使用场景

每个状态码都包含真实的使用场景，说明服务器何时以及为什么返回该特定代码。

为 API 设计选择正确的状态码
调试时理解错误响应
学习 HTTP 响应的最佳实践

收藏和快速访问

收藏您最常用的状态码，使它们始终显示在顶部。

收藏保存在浏览器本地
无需账户
跨会话持久保存

专业提示：将颜色编码分类和收藏功能结合使用，为您在项目中最常用的状态码创建个性化的快速参考指南。

常见问题

401 和 403 有什么区别？

401 Unauthorized

需要身份验证

客户端未提供有效的身份验证凭证。客户端应进行身份验证（登录）并重试。

用户需要登录
缺少或无效的凭证
重新身份验证将解决问题

403 Forbidden

权限被拒绝

客户端已通过身份验证但无权访问该资源。重新身份验证无法解决问题。

用户已登录但缺少权限
访问受角色或策略限制
身份验证无法解决问题

何时应使用 301 vs 302 重定向？

301 Moved Permanently

永久重定向

当资源永久移动到新 URL 时使用。搜索引擎将更新其索引。

域名更改或迁移
URL 结构调整
永久内容重定位
SEO 价值转移到新 URL

302 Found

临时重定向

用于临时重定向，其中原始 URL 在将来仍应使用。

维护页面重定向
A/B 测试场景
临时内容重定位
SEO 价值保留在原始 URL

400 和 422 有什么区别？

400 Bad Request

格式错误的请求

请求格式错误 — 服务器无法解析它。

无效的 JSON 语法
格式错误的 XML 结构
缺少必需的请求头
语法级错误

422 Unprocessable Content

语义错误

请求在语法上正确但在语义上无效。

有效的 JSON 但字段值无效
业务逻辑验证失败
数据类型不匹配
语义级错误

502 Bad Gateway 是什么意思？

502 Bad Gateway 错误意味着充当网关或代理的服务器从上游服务器收到了无效响应。

常见原因

反向代理（如 Nginx）无法连接到后端应用程序
后端服务器已关闭或过载
后端返回格式错误的响应
代理和后端之间的网络连接问题
等待上游服务器响应超时

故障排除提示：检查您的后端应用程序日志，并确保上游服务器正在运行且可从代理服务器访问。

我的收藏代码会被保存吗？

是的。收藏的代码保存在浏览器的本地存储中，跨页面刷新和浏览器会话持久保存。

无需账户或服务器连接
数据存储在浏览器本地
跨会话和页面刷新持久保存
仅限您的浏览器私密使用