实用指南

HTTP状态码 — 使用指南与技术原理

HTTP状态码参考

打开工具

概述

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

核心概念

什么是 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 状态码参考,涵盖 1xx 到 5xx 所有标准状态码,包含每个状态码的详细描述、含义和使用场景

智能搜索与过滤

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

分类组织展示

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

详细使用指导

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

常见问题

为什么 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状态码

回到工具页面,立即使用相关功能。

打开工具