📊

HTTP状态码

HTTP状态码参考

实用指南
搜索状态码
状态码
代码名称HTTP状态码参考类别
100继续服务器已收到请求头,客户端应继续发送请求体。信息性
101切换协议请求者要求服务器切换协议,服务器已同意。信息性
102处理中服务器已收到并正在处理请求,但尚未提供响应。信息性
103早期提示用于在最终 HTTP 消息之前返回一些响应头。信息性
200成功请求成功。返回的信息取决于请求中使用的方法。成功
201已创建请求已满足并导致创建了新资源。成功
202已接受请求已被接受进行处理,但处理尚未完成。成功
203非权威信息服务器成功处理了请求,但返回的信息可能来自其他来源。成功
204无内容服务器成功处理了请求,但不返回任何内容。成功
205重置内容服务器成功处理了请求,但不返回任何内容,并要求请求者重置文档视图。成功
206部分内容由于客户端发送的范围头,服务器只传递资源的一部分。成功
207多状态后续的消息体是 XML 消息,可以包含多个单独的响应代码。成功
208已报告DAV 绑定的成员已在多状态响应的前一部分中枚举。成功
226IM 已使用服务器已满足对资源的请求,响应是对当前实例应用的一个或多个实例操作结果的表示。成功
300多种选择请求有多个可能的响应。用户代理或用户应选择其中一个。重定向
301永久重定向请求资源的 URL 已永久更改。新 URL 在响应中给出。重定向
302临时重定向请求资源的 URI 已临时更改。将来可能会对 URI 进行进一步更改。重定向
303查看其他服务器发送此响应以指示客户端使用 GET 请求在另一个 URI 获取请求的资源。重定向
304未修改用于缓存目的。它告诉客户端响应未被修改。重定向
305使用代理请求的资源只能通过代理获得,代理地址在响应中提供。重定向
  • 显示 1-20 共 63 项
  • 1
  • 2
  • 3
  • 4
  • 跳至页
类别
信息性
请求已接收,继续处理
成功
请求已成功接收并处理
重定向
需要进一步操作完成请求
客户端错误 (4xx)
请求语法错误或无法完成
服务器错误 (5xx)
服务器无法完成有效请求
常见状态码
200 OK: OK - 请求成功
301 Moved Permanently: 永久移动 - 资源已永久移动
404 Not Found: 未找到 - 服务器无法找到请求的资源
500 Internal Server Error: 内部服务器错误 - 服务器遇到错误

❓什么是 HTTP状态码

HTTP状态码在客户端和服务器之间传达Web请求的结果。对于Web开发、API设计和调试网络通信至关重要。

✨Features

📚

完整的状态码库

全面的 HTTP 状态码参考,涵盖 1xx 到 5xx 所有标准状态码,包含每个状态码的详细描述、含义和使用场景
🔍

智能搜索与过滤

通过编号、名称或描述快速查找状态码。按类别(信息性、成功、重定向、客户端错误、服务器错误)过滤,即刻定位相关状态码
🏷️

分类组织展示

按照 RFC 7231 标准分类组织状态码,使用彩色标签区分,一目了然地理解每个响应的性质
📖

详细使用指导

每个状态码都包含实际示例、常见用例和最佳实践,帮助您在 REST API 和 Web 应用中正确实现

📚实用指南

什么是 HTTP 状态码

HTTP 状态码是服务器返回的三位数字,用于表示 HTTP 请求的处理结果。根据 RFC 7231 标准定义,状态码分为五大类:1xx(信息性响应)、2xx(成功)、3xx(重定向)、4xx(客户端错误)、5xx(服务器错误)。每个状态码都提供关于请求处理结果的特定信息。

请求-响应机制

当客户端向服务器发送 HTTP 请求时,服务器处理请求后会在响应头中返回状态码。状态行格式为:HTTP/1.1 200 OK。客户端应用程序根据状态码决定下一步操作:遇到 5xx 错误时重试、收到 3xx 时进行重定向、处理 401/403 进行身份验证等。

状态码分类详解

1xx 表示正在处理中(100 Continue、101 Switching Protocols)。2xx 表示操作成功(200 OK、201 Created、204 No Content)。3xx 要求客户端重定向(301 永久移动、302 临时重定向、304 未修改)。4xx 表示客户端错误(400 错误请求、401 未授权、404 未找到)。5xx 表示服务器故障(500 内部错误、502 网关错误、503 服务不可用)。

RESTful API 设计应用

在 RESTful API 设计中,正确使用状态码至关重要。POST 请求创建资源应返回 201,PUT/PATCH 更新资源返回 200 或 204,DELETE 删除成功返回 204。使用 400 表示验证错误,401 表示缺少身份验证,403 表示权限不足,409 表示冲突。这种标准化提高了 API 的可用性和客户端错误处理能力。

💬常见问题

❓为什么 HTTP 状态码对开发者很重要?
它是客户端与服务器之间的契约。正确的状态码告诉你是否需要重试、提示登录、跟随重定向或展示友好的错误信息,也有助于日志监控和 API 文档。
💬4xx 和 5xx 有什么区别?
4xx 表示请求本身有问题(400 语法错误、401 未授权、404 资源不存在)。5xx 表示服务器接受了请求但处理失败(500 程序异常、502 上游错误、503 过载)。4xx 通常由客户端修复,5xx 由服务器端修复。
🔍什么时候用 301/302/307/308?
301/308 为永久重定向,浏览器会缓存;302/307 为临时。301/302 可能把方法改成 GET,而 307/308 会保留原方法和请求体。需要永久保持 POST/PUT 时推荐 308。
💡如何在命令行查看状态码?
可运行 `curl -I URL`,或 `curl -w "%{http_code}" -o /dev/null -s URL` 只输出状态码。`wget --spider --server-response` 及 HTTPie、Postman 等工具也适用。
📚可以自定义状态码吗?
只有 IANA 注册的 100–599 属于标准码。某些服务会用 599 等非标准码,但客户端未必识别。最好使用标准状态码,并把错误详情放进响应体。

💡如何检查 HTTP 状态码

🌐

使用浏览器开发者工具

打开浏览器开发者工具(F12),切换到网络(Network)标签页,刷新页面,在状态(Status)列中可以看到每个请求的 HTTP 状态码。
💻

使用 curl 命令

在终端运行 'curl -I https://example.com' 可以只获取响应头信息(包括状态码),或运行 'curl -w '%{http_code}' -o /dev/null -s https://example.com' 仅显示状态码。
📡

使用 wget 命令

运行 'wget --spider --server-response https://example.com' 可以在不下载文件的情况下检查状态码。HTTP 响应代码会显示在输出中。
🔍

使用在线工具

使用在线 HTTP 状态码检查器或本工具可以快速验证状态码,无需安装任何软件。只需输入 URL 即可检查。

🔗Related Documents

User Comments

0 / 2000
Loading...