什么是 HTTP 状态码？一文搞懂 – wiki基地

---

一文搞懂：HTTP 状态码详解

互联网世界纷繁复杂，我们每天都在通过浏览器、App 与无数的服务器进行着数据交互。你打开一个网页、提交一个表单、下载一个文件，这些操作背后都遵循着同一个核心协议——HTTP（Hypertext Transfer Protocol，超文本传输协议）。

HTTP 协议定义了客户端（通常是浏览器）如何向服务器请求资源，以及服务器如何将资源连同处理结果一同响应给客户端。而在这个“请求-响应”的对话中，有一个至关重要的组成部分，它就像是服务器在告诉客户端：“我收到了你的请求，处理结果是……”。这就是我们今天要深入探讨的主题：HTTP 状态码（HTTP Status Code）。

理解 HTTP 状态码，无论你是开发者、运维工程师，还是仅仅对网络技术感兴趣的普通用户，都能更好地诊断问题、优化应用、甚至提升对网页加载过程的认知。

什么是 HTTP 状态码？它在哪里？

简单来说，HTTP 状态码是一个三位数的数字代码，包含在服务器发送回客户端的 HTTP 响应报文的第一行。这行报文通常被称为“状态行”，它的格式是这样的：

HTTP/1.1 200 OK

或者

HTTP/1.1 404 Not Found

在这两个例子中：
* HTTP/1.1 表示使用的 HTTP 协议版本。
* 200 和 404 就是 HTTP 状态码。
* OK 和 Not Found 是与状态码对应的“状态文本”（Status Text），它提供了状态码的简短文字描述，方便人们理解，但协议规定客户端应该主要依赖数字状态码来判断结果。

状态码的任务就是告知客户端，服务器端处理请求的结果。它告诉客户端这次请求是成功了、需要进一步操作、还是出错了。

HTTP 状态码的五大类别

为了更好地组织和理解状态码，HTTP 协议将其分为了五大类，每一类都由不同的百位数开头，表示了不同的大致含义：

1. 1xx (信息类 – Informational): 表示服务器已接收到请求的头部，客户端应继续发送请求的主体部分或忽略此响应。这类状态码比较少见于日常网页浏览。
2. 2xx (成功类 – Successful): 表示请求已被服务器成功接收、理解、并接受。这是最常见的成功状态码。
3. 3xx (重定向类 – Redirection): 表示客户端需要采取进一步的操作（通常是跳转到另一个 URL）才能完成请求。常用于网页地址迁移。
4. 4xx (客户端错误类 – Client Error): 表示客户端发送的请求存在错误或无法完成。这是服务器在说：“你的请求有问题！”
5. 5xx (服务器错误类 – Server Error): 表示服务器在处理请求时发生了内部错误。这是服务器在说：“我这里出错了，我搞不定了！”

接下来，我们将详细讲解每一类中常见和重要的状态码。

详细解读各类状态码

1xx 信息类 (Informational)

这类状态码表示服务器已经收到了请求，并且请求正在继续处理。它们通常是临时响应，最终需要一个最终响应来结束请求。

• 100 Continue (继续): 客户端发送一个期望包含请求主体的请求（如 POST 或 PUT），服务器在接收到请求头部后返回此状态码，表示客户端可以继续发送请求主体。如果客户端没有发送 Expect: 100-continue 头部，通常不会看到这个状态码。

2xx 成功类 (Successful)

这类状态码表示客户端的请求已成功被服务器接收、理解和处理。

• 200 OK (成功): 这是最常见和最理想的状态码。表示请求成功，服务器已返回客户端请求的数据。例如，你成功访问一个网页，通常就会看到 200 状态码。
• 201 Created (已创建): 请求成功，并且服务器创建了新的资源。这通常是在执行 POST 请求时返回的状态码，表示新的资源已被成功创建，并且响应中通常会包含新资源的 URI。
• 202 Accepted (已接受): 服务器已接受请求，但尚未处理完成。请求可能正在被处理，或者服务器可能拒绝处理该请求。这通常用于异步处理的场景。
• 204 No Content (无内容): 服务器成功处理了请求，但不需要返回任何实体内容。客户端通常不会因为接收到此响应而离开当前页面。例如，一个保存操作成功，但页面无需刷新，可以返回 204。
• 205 Reset Content (重置内容): 服务器成功处理了请求，并且客户端应该重置导致发送请求的文档视图。例如，清除表单上的数据。
• 206 Partial Content (部分内容): 服务器成功处理了部分 GET 请求。这通常用于文件下载或媒体流，客户端可以通过指定 Range 头部来请求资源的某个部分。

3xx 重定向类 (Redirection)

这类状态码表示为了完成请求，客户端需要进行进一步的操作，通常是访问另一个 URL。

• 300 Multiple Choices (多种选择): 请求的资源有多种表示，服务器列出了可能的选择。用户或用户代理需要选择其中一个。
• 301 Moved Permanently (永久移动): 请求的资源已被永久移动到新的位置。新的 URL 会在响应的 Location 头部中给出。客户端应该更新到新的 URL，并且后续请求也应该使用新的 URL。这对 SEO 非常重要。
• 302 Found (临时移动): 请求的资源暂时移动到新的位置。新的 URL 会在响应的 Location 头部中给出。客户端应该继续使用原有的 URL 进行后续请求，因为资源随时可能移回原位置。早期 HTTP/1.0 版本中的状态码，后来在 HTTP/1.1 中引入了 303 和 307 进行了更精确的区分。
• 303 See Other (查看其他位置): 服务器通知客户端在另一个 URL 地址上通过 GET 方法获取请求的资源。这通常是在 POST 或 PUT 请求后返回，指示客户端应该去获取一个不同的资源（例如，操作结果页面），而不是直接获取原始请求的资源。
• 304 Not Modified (未修改): 客户端请求的资源自上次访问以来没有发生修改。这通常是在客户端发送了包含 If-Modified-Since 或 If-None-Match 头部的有条件请求时返回的。服务器返回此状态码时，不会返回响应主体，客户端可以使用本地缓存的副本。这有助于提高性能和节省带宽。
• 307 Temporary Redirect (临时重定向): 请求的资源暂时移动到新的 URL。与 302 类似，但 HTTP/1.1 明确要求客户端在重定向时不能改变请求方法（POST 请求重定向后仍然是 POST，而 302 可能会被一些客户端错误地改为 GET）。
• 308 Permanent Redirect (永久重定向): 请求的资源已被永久移动到新的 URL。与 301 类似，但 HTTP/1.1 明确要求客户端在重定向时不能改变请求方法（POST 请求重定向后仍然是 POST）。

4xx 客户端错误类 (Client Error)

这类状态码表示客户端发送的请求存在错误。这意味着问题出在请求方，而不是服务器。

• 400 Bad Request (错误请求): 服务器无法理解客户端发送的请求，因为请求语法错误或包含无效信息。例如，请求体格式不对（如发送了错误的 JSON 格式）。
• 401 Unauthorized (未授权): 请求需要用户身份认证。客户端通常需要提供用户名和密码（或其他认证方式）才能访问资源。注意，这个状态码是指未认证，而不是没有权限。
• 403 Forbidden (禁止访问): 服务器拒绝了客户端的请求。与 401 不同，403 表示服务器已经理解了请求，也知道了你是谁（可能你已经认证过了），但仍然拒绝访问，因为你没有足够的权限。
• 404 Not Found (未找到): 服务器找不到请求的资源。这是最常见的客户端错误之一，比如你访问了一个不存在的网页地址。
• 405 Method Not Allowed (方法不允许): 客户端使用了服务器不支持的 HTTP 方法来请求资源。例如，对一个只允许 GET 请求的资源使用了 POST 方法。
• 408 Request Timeout (请求超时): 服务器在等待客户端发送请求时超时。客户端没有在指定的时间内完成发送请求。
• 409 Conflict (冲突): 请求因为冲突而无法提交。例如，在你更新一个资源时，该资源已经被别人修改过了。
• 410 Gone (已失效): 请求的资源已被永久删除，且知道将来也不会再有。与 404 类似，但 410 表示资源是曾经存在但现在确定没了，而 404 可能只是暂时找不到。
• 413 Payload Too Large (请求体太大): 客户端发送的请求主体（例如上传的文件）超出了服务器的处理能力或限制。
• 414 URI Too Long (URI 太长): 请求的 URI（通常是 URL）过长，服务器无法处理。
• 415 Unsupported Media Type (不支持的媒体类型): 服务器不支持请求中指定的媒体类型。例如，你尝试上传一个服务器不支持的文件格式。
• 429 Too Many Requests (请求过多): 客户端在短时间内发送了过多的请求，超出了服务器的速率限制。这是一种常见的反爬虫或防止滥用的机制。
• 431 Request Header Fields Too Large (请求头部字段太大): 服务器不愿意处理请求，因为一个或多个头部字段过大，或者整个头部字段集合过大。

5xx 服务器错误类 (Server Error)

这类状态码表示服务器在处理有效的请求时发生了内部错误。问题出在服务器端。

• 500 Internal Server Error (服务器内部错误): 这是最通用的服务器端错误状态码。表示服务器遇到了一个不知道如何处理的错误。通常是服务器代码执行过程中发生了未捕获的异常或其他内部故障。
• 501 Not Implemented (未实现): 服务器不支持当前请求所需的功能。这通常意味着服务器无法识别请求方法，或者没有能力完成请求。
• 502 Bad Gateway (错误的网关): 作为网关或代理的服务器尝试连接上游服务器时收到了一个无效的响应。常见的场景是前端服务器（如 Nginx）作为反向代理连接后端应用服务器时，后端服务器返回了错误。
• 503 Service Unavailable (服务不可用): 服务器当前无法处理请求，这通常是由于服务器过载或停机维护。这是一个临时状态，通常会在一段时间后恢复。响应中可能包含 Retry-After 头部，告知客户端何时可以重试。
• 504 Gateway Timeout (网关超时): 作为网关或代理的服务器在等待上游服务器响应时超时。与 502 类似，但 504 是因为等待超时，而不是收到无效响应。
• 505 HTTP Version Not Supported (HTTP 版本不受支持): 服务器不支持请求中所使用的 HTTP 协议版本。

为什么理解状态码很重要？

理解 HTTP 状态码对于不同的角色都非常有益：

• 对于开发者： 状态码是 API 设计、后端逻辑处理和前端错误处理的关键依据。正确返回和处理状态码是构建健壮应用的基础。当出现 4xx 或 5xx 错误时，状态码是定位问题的第一步。
• 对于运维工程师： 监控服务器日志和性能时，状态码是判断服务健康状况的重要指标。大量的 4xx 可能意味着用户请求有问题或接口被误用；大量的 5xx 则直接指向服务器内部故障，需要立即排查。
• 对于 SEO 专家： 301 和 302 重定向对网站的搜索引擎排名有直接影响。理解这些状态码能帮助优化网站结构和迁移过程。404 错误页面也需要妥善处理，避免影响用户体验和爬虫抓取。
• 对于普通用户： 虽然普通用户很少直接看到数字状态码，但浏览器或应用会根据这些状态码显示用户友好的错误信息（比如常见的“404 页面未找到”）。了解这些数字背后的含义，能让你更好地理解网络问题提示。

如何查看 HTTP 状态码？

作为普通用户，你可能直接看到浏览器提供的错误页面。但如果你想查看任何一个 HTTP 请求的详细状态码，可以使用浏览器的开发者工具：

1. 打开你想查看的网页。
2. 按下 F12 键（或右键点击页面，选择“检查”或“审查元素”）。
3. 切换到“Network”（网络）或类似的标签页。
4. 刷新页面（如果需要）。
5. 你会看到该页面加载过程中发出的所有请求。点击某个请求（通常是主文档请求或你关心的某个资源请求），在右侧或下方会显示请求和响应的详细信息，其中包括 HTTP 状态码。

总结

HTTP 状态码是服务器与客户端之间沟通请求处理结果的标准语言。它们简洁而强大，通过一个三位数的数字，就能传达出请求是成功、需要重定向、还是发生了客户端或服务器端的错误。

通过本文的详细介绍，你应该对 HTTP 状态码有了全面的认识，了解了它们的五大分类以及各类中常见的状态码的含义和应用场景。下次当你看到一个神秘的三位数代码出现在网络请求中时，希望你能不再感到困惑，而是能迅速定位问题的大方向。理解这些“沉默的数字”，将帮助你更好地畅游在互联世界里。