快速、支持搜索的 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 生成器。