跳到正文
SPCXTools

HTTP 状态码

搜索并筛选标准 HTTP 响应代码,快速了解服务器错误与状态信息。

本地运行——文件不会离开你的设备

正在加载工具…

如何使用HTTP 状态码

  1. 1在搜索框中输入状态码数字(例如“404”)或名称(例如“Not Found”)。
  2. 2使用分类筛选器(1xx、2xx、3xx、4xx、5xx)浏览特定类别的 HTTP 响应代码。
  3. 3阅读每个代码下方的说明,了解其含义以及服务器在何种情况下会返回该代码。

快速、支持搜索的 HTTP 状态码大全

每次浏览器、移动应用或搜索引擎爬虫向 Web 服务器发起请求时,服务器都会返回一个三位数的数字。这些 HTTP 状态码能准确告诉客户端处理的结果:请求是成功、失败、需要身份验证,还是需要重定向到其他地址。

本工具提供基于官方 RFC 规范的完整 HTTP 响应码查询手册,并支持实时搜索。由于所有数据均在您的浏览器本地加载与过滤,搜索结果瞬间呈现。无需等待页面刷新,即可快速查询 301 和 302 的区别,或查找 422 错误的具体含义。

HTTP 响应状态码的五大分类

HTTP 状态码按首位数字分为五大类。了解这些分类是排查网络请求问题最快捷的方式:

1xx (信息)
这些状态码表示服务器已接收到请求并正在继续处理。它们是临时响应,客户端应等待最终响应。例如,100 Continue 告诉客户端可以继续发送请求体。

2xx (成功)
2xx 状态码表示客户端的请求已被成功接收、理解并接受。最常见的是 200 OK,这是 HTTP 请求成功的标准响应。通过 API 创建新记录时,您可能会看到 201 Created。

3xx (重定向)
这些状态码告诉客户端需要采取进一步操作才能完成请求。这通常意味着请求的资源已被移动。301 Moved Permanently 告诉搜索引擎更新其链接,而 302 Found 则表示临时移动。

4xx (客户端错误)
4xx 范围内的 HTTP 错误码意味着问题出在客户端。请求可能包含语法错误、缺乏正确的身份验证,或者请求了不存在的资源。当用户输错 URL 或 API 集成发送了格式不正确的数据时,这些错误很常见。

5xx (服务器错误)
5xx 状态码表示服务器未能满足有效的请求。客户端的操作完全正确,但服务器遇到了内部问题、崩溃或当前已超载。

你应该了解的常见 HTTP 错误码

虽然状态码有几十种,但作为开发者或站长,你遇到的大多数错误都集中在以下几个:

404 状态码 (Not Found)
这可能是互联网上最著名的错误,404 状态码表示服务器无法找到请求的资源。对于站长而言,监控 404 错误对 SEO 至关重要,因为死链不仅影响用户体验,还会浪费爬虫抓取预算。

400 Bad Request
由于客户端错误(如请求语法错误或路由无效),服务器无法处理该请求。当缺少必填参数时,API 通常会返回此错误。

401 Unauthorized & 403 Forbidden
两者都与访问权限有关。401 Unauthorized 表示客户端必须进行身份验证才能获取请求的响应(例如,缺少 API 密钥)。403 Forbidden 表示客户端身份已知,但没有访问该资源的权限。

500 Internal Server Error
这是服务器端崩溃的通用报错。它表示服务器遇到了意外情况,导致无法完成请求。当你遇到 500 错误时,通常需要检查服务器的应用日志来找出根本原因。

502 Bad Gateway & 503 Service Unavailable
当作为代理的服务器(如 Nginx 或负载均衡器)从上游服务器收到无效响应时,就会出现 502 Bad Gateway 错误。503 Service Unavailable 表示服务器当前无法处理请求,通常是因为服务器超载或正在停机维护。

API 开发最佳实践

构建 REST API 时,返回正确的 HTTP 状态码对于提供良好的开发者体验至关重要。如果在实际发生错误时返回 200 OK(通常称为“吞没”错误),会迫使客户端手动解析响应体,才能判断请求是否真正成功。

请使用本参考指南来选择语义最准确的状态码。例如,当用户触发限流时,请使用 429 Too Many Requests;当 JSON 负载格式有效但未通过业务逻辑验证时,请使用 422 Unprocessable Content。

如果您正在排查服务器路由问题,我们的 DNS 查询 工具可以帮助您验证域名记录,您也可以使用 User-Agent 解析 工具来了解向您的服务器发起请求的客户端信息。如果您想管理搜索引擎抓取网站的方式以防止出现 404 错误,请尝试使用 Robots.txt 生成器。

常见问题

什么是 HTTP 状态码?
HTTP 状态码是服务器响应客户端(如网页或 API)请求时返回的三位数字。它们指示特定的 HTTP 请求是成功完成、重定向还是发生错误。
不同的状态码分类(1xx 到 5xx)代表什么?
状态码的首位数字代表响应类别。1xx 表示信息提示,2xx 表示请求成功,3xx 表示重定向,4xx 表示客户端错误(如 URL 错误),5xx 表示服务器错误(如崩溃或超载)。
什么是 404 状态码?
404 状态码表示“未找到”(Not Found)。当服务器无法找到请求的资源时会返回此状态码。通常是因为用户点击了死链、输入了错误的 URL,或者页面已被删除且未设置重定向。
4xx 和 5xx HTTP 错误码有什么区别?
4xx 错误属于“客户端错误”,表示问题出在请求方(例如请求了不存在的页面或未授权)。5xx 错误属于“服务器错误”,表示客户端的请求有效,但服务器因内部故障无法处理该请求。
为什么会出现 418 "I'm a teapot" 错误?
418 状态码是 HTTP 协议中著名的彩蛋。它源于 1998 年愚人节发布的 RFC 2324(超文本咖啡壶控制协议)恶搞文档。虽然它不用于实际生产环境,但有些 Web 服务器和 API 会把它当作玩笑返回。
使用这个工具需要联网吗?
仅在首次加载页面时需要联网。之后,整个列表和搜索功能都将通过 JavaScript 在您的浏览器中本地运行,这意味着搜索是即时的,无需任何服务器请求。