开发者参考资料

HTTP 状态码含义与排查线索

输入数字或名称,按响应类别筛选,再查看有来源的示例与排查起点。

HTTP 状态码

代码或名称

匹配条目

1xx 信息响应
2xx 成功
3xx 重定向
4xx 客户端错误
5xx 服务器错误

选中的响应

502 Bad Gateway

5xx 服务器错误

含义: 网关或代理收到无效的上游响应。

常见情况: 上游连接或回复损坏。

优先检查: 检查代理日志和上游健康状况,并与 504 超时区分。

示意 HTTP 响应

虚构的 HTTP/1.1 示例;实际服务器的响应头和正文可能不同。

HTTP/1.1 502 Bad Gateway
Content-Type: application/problem+json

{"title":"Bad Gateway","status":502}

搜索只筛选浏览器内的静态资料。只有主动打开来源或工具链接才会离开本页。

响应类别

精选 28 条中匹配 28 条 · 当前为 502

IANA 注册表最后更新:2025 年 9 月 15 日本站资料核对:2026 年 9 月 23 日
检查响应头

接口日志里只剩一个数字时,真正的问题可能在请求、网关或上游服务。这个 HTTP 状态码参考把协议含义、示例和第一步检查放在一起,避免把所有 5xx 都当成同一种故障。

先用 HTTP 状态码定位方向,再查看真实响应头、响应体和服务端日志。这里是精选条目,不是在线探测器;完整注册表仍以 IANA 为准。

为什么用这份 HTTP 状态码参考

一个代码只指明方向,接下来要查哪一层取决于响应是怎么产生的。

分清错误响应与超时

HTTP 状态码 502 和 504 都可能由网关返回,但前者是收到无效的上游响应,后者是等不到及时响应;第一步检查并不相同。

两条网关路径中,一条收到破损的上游响应,另一条等待到时钟超时

从查表走向证据

搜索 429 可看到 Retry-After 响应头示例和优先检查项。每条 HTTP 状态码记录还连接定义它的 RFC 与 IANA 注册表。

搜索将多张参考卡筛成一张,结果旁显示重试时钟与检查清单

先理解信号,再动手修复

01

查数字,也查含义

空搜索显示精选 28 条;数字、英文短语及中文含义都能查。五类筛选只作用于当前已提交的查询。

02

对照容易混淆的代码

默认 502 可和 504 比较“无效响应”与“响应超时”;示例 429 展示 Retry-After,而 302 与 307 的请求方法处理不同。

03

回到真实请求核实

页面示例是虚构的 HTTP/1.1 片段。打开 RFC,检查真实响应头和日志;未找到的代码只能说明不在本页精选范围。

一条记录同时提供三种线索

五类本地索引

这份 HTTP 状态码大全精选 28 个 1xx 至 5xx 条目,支持本地数字、英文名称和中文含义检索。

响应示例与必要响应头

204 和 304 的示例没有正文;401、405、429 分别展示有助于判断的认证、方法或重试响应头。

直接核对定义来源

每条都有 RFC 和 IANA 链接,便于把 HTTP 响应状态码的规范含义与应用层错误区分开。

范围与判断边界

精选不等于全集
本页只收录 28 条。未收录的厂商代码不自动判为无效;完整范围请查 IANA。本页不会为 404 或 502 另建页面。
不做实时诊断
状态码查询只读静态资料,不会请求目标 URL 或读取日志。单凭 502 不能判断故障在 CDN、网关还是源站。
示例不是抓包结果
展示的是虚构 HTTP/1.1 文本;HTTP/2、HTTP/3 的线格式以及真实响应体可能不同。
重试还要看上下文
429 和 503 可能附带 Retry-After,但写入请求能否重试还取决于幂等性与服务策略。

HTTP 状态码常见问题

HTTP 状态码分哪几类?

分为 1xx 信息响应、2xx 成功、3xx 重定向、4xx 客户端错误和 5xx 服务器错误。这份 HTTP 状态码参考精选 28 条,完整注册表可从详情打开。

401 和 403 有什么区别?

401 表示缺少有效认证,通常要看 WWW-Authenticate;403 表示服务器理解请求却拒绝执行,已认证用户也可能没有权限。

404 和 410 该怎么选?

404 表示当前没有找到资源,不说明是否永久消失;明确知道资源永久移除时,410 更具体。

遇到 429 应该怎么处理?

先读 Retry-After(如果存在)与服务的限流策略,再判断该请求是否能安全重试;别只根据代码立即重发写入操作。

502 和 504 的排查方向有什么不同?

502 指网关收到无效上游响应,504 指在期限内没收到响应。先核对代理和上游日志,再确定实际故障层。

缺少某个代码或排查线索?

现在使用 HTTP 状态码参考

查到代码后,对照真实响应头,再打开定义来源确认语义,然后决定客户端或服务端的下一步。