什么是 HTTP 状态码
HTTP 状态码是服务器返回的三位数字,用于表示 HTTP 请求的处理结果。根据 RFC 7231 标准定义,状态码分为五大类:1xx(信息性响应)、2xx(成功)、3xx(重定向)、4xx(客户端错误)、5xx(服务器错误)。每个状态码都提供关于请求处理结果的特定信息。
Preparing your comprehensive developer toolkit
实用指南
HTTP状态码参考
HTTP状态码在客户端和服务器之间传达Web请求的结果。对于Web开发、API设计和调试网络通信至关重要。
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 设计中,正确使用状态码至关重要。POST 请求创建资源应返回 201,PUT/PATCH 更新资源返回 200 或 204,DELETE 删除成功返回 204。使用 400 表示验证错误,401 表示缺少身份验证,403 表示权限不足,409 表示冲突。这种标准化提高了 API 的可用性和客户端错误处理能力。
全面的 HTTP 状态码参考,涵盖 1xx 到 5xx 所有标准状态码,包含每个状态码的详细描述、含义和使用场景
通过编号、名称或描述快速查找状态码。按类别(信息性、成功、重定向、客户端错误、服务器错误)过滤,即刻定位相关状态码
按照 RFC 7231 标准分类组织状态码,使用彩色标签区分,一目了然地理解每个响应的性质
每个状态码都包含实际示例、常见用例和最佳实践,帮助您在 REST API 和 Web 应用中正确实现
它是客户端与服务器之间的契约。正确的状态码告诉你是否需要重试、提示登录、跟随重定向或展示友好的错误信息,也有助于日志监控和 API 文档。
4xx 表示请求本身有问题(400 语法错误、401 未授权、404 资源不存在)。5xx 表示服务器接受了请求但处理失败(500 程序异常、502 上游错误、503 过载)。4xx 通常由客户端修复,5xx 由服务器端修复。
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 状态码参考,包含解释和示例
IETF 官方标准,定义 HTTP 状态码语义
所有 HTTP 状态码的官方注册表
HTTP 状态码快速参考指南
IETF 的 HTTP 基本认证标准
回到工具页面,立即使用相关功能。