HTTP 状态码速查

Q: 401 和 403 到底怎么区分？

401 Unauthorized 本意是「未认证」：客户端没有身份凭证或凭证无效/过期，应配合 WWW-Authenticate 响应头提示如何认证，客户端通常需要重新登录或刷新 Token。403 Forbidden 是「已认证但无权限」：服务器知道你是谁，但你的角色无权访问该资源，重新登录也没用。记法：401 不知道你是谁，403 知道你是谁但不许。

Q: 301、302、307、308 四个重定向怎么选？

按「永久还是临时 × 是否保持请求方法」两维选择：301 永久 + 可能改方法（历史原因 POST 可能被转成 GET）；308 永久 + 严格保持方法；302 临时 + 可能改方法；307 临时 + 严格保持方法。换域名、强制 HTTPS 用 301；登录后跳转、临时维护用 302；API 地址永久迁移用 308；POST 跨域临时跳转用 307。另外 303 专用于「POST 完成后跳结果页」（PRG 模式），明确要求改用 GET 访问。

Q: 为什么视频拖进度条会用到 206？

视频播放器拖动进度条时，会通过 Range: bytes=xxxx-yyyy 请求头向服务器只请求缺失的那一段数据，服务器返回 206 Partial Content 和对应的 Content-Range。这也是断点续传、大文件分片下载的原理。如果请求的范围超出了文件实际大小，服务器会返回 416 Range Not Satisfiable。

Q: 502、503、504 排查线上问题时分别意味着什么？

502：网关（如 Nginx）收到了后端的非法响应或连接被拒绝，通常是 PHP-FPM/Node 进程崩了、脚本 fatal error；503：服务过载或正在维护，负载均衡器把节点摘除时也会返回它，可带 Retry-After；504：网关在超时时间内没等到后端响应，通常是慢 SQL、外部接口卡死、超时配置过短。排查顺序：先看 502 的后端错误日志，504 则重点查慢查询与上游超时配置。

Q: PUT/DELETE 成功后应该返回什么状态码？

推荐：PUT/PATCH 更新成功返回 200（带最新资源内容）或 204（无返回体）；DELETE 删除成功返回 204 或 200；POST 创建资源成功返回 201，并带 Location 头指向新资源地址。不要创建/更新成功还返回 201/200 之外让人误解的码，也不要用 404 表达「删过了再删一次」。

网络调试完全免费 🔍 关键字搜索 📊 分类标签筛选 📥 离线可用 🌙 支持黑夜模式

58 个常用 HTTP 状态码按 5 大类整理：1xx 信息响应、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误。每个状态码都配含义 + 真实使用场景，支持关键字即时搜索与分类切换，接口调试、排查报错时随手一查。

类别程序员 · 文档速查

运行方式纯前端 · 离线运行

状态码数量5 大类 · 58 个常用状态码

数据存储无存储

📡 HTTP 状态码速查

按类别切换或直接搜索，每条含含义 + 使用场景

💬 1xx 信息响应（服务器已收到请求，继续处理中）

100 Continue · 客户端应继续发送请求体 场景：客户端发送大请求体前用 Expect: 100-continue 探测服务器是否愿意接收，避免白传几十 MB

101 Switching Protocols · 服务器同意切换协议 场景：WebSocket、HTTP/2 升级握手时返回，配合 Upgrade 请求头使用

102 Processing · 服务器已收到，仍在处理 场景：WebDAV 复杂请求处理超过 20 秒时返回，防止客户端超时断开

103 Early Hints · 预提示，最终响应稍后到 场景：在正式响应前让浏览器预加载关键 CSS/JS 资源，加速首屏渲染

🚫 4xx 客户端错误（请求有误，客户端需要修改后重试）

400 Bad Request · 请求语法错误 场景：参数缺失、格式非法、JSON 解析失败等，最通用的客户端错误

401 Unauthorized · 未认证 场景：未登录或 Token 无效/过期，应返回 WWW-Authenticate 头；记住「不知道你是谁」

402 Payment Required · 需要付费 场景：保留码，实践中常用于付费墙、订阅过期的业务提示

403 Forbidden · 已认证但无权限 场景：登录了但角色权限不够、IP 被封禁；重新登录也没用，记住「知道你是谁但不许」

404 Not Found · 资源不存在 场景：URL 写错或资源已删除；别用它掩盖服务端异常，出错就该抛 5xx

405 Method Not Allowed · 方法不允许 场景：对只读接口发 POST；应返回 Allow 头说明支持的方法

406 Not Acceptable · 无法满足 Accept 要求 场景：客户端要求的 Content-Type 服务端不支持，检查 Accept 头

407 Proxy Authentication Required · 需要代理认证 场景：公司内网代理要求先完成代理认证才能放行

408 Request Timeout · 请求超时 场景：客户端发请求太慢，服务器等待超时主动断开连接

409 Conflict · 请求冲突 场景：并发编辑互相覆盖、批量操作部分冲突、版本号不一致时使用

410 Gone · 资源已永久删除 场景：活动页下线用 410 而非 404，明确告诉搜索引擎删掉索引

411 Length Required · 需要 Content-Length 场景：服务端要求显式长度，不接受不定长的分块上传

412 Precondition Failed · 前置条件失败 场景：If-Match/If-Unmodified-Since 条件不满足，乐观锁冲突常用

413 Payload Too Large · 请求体过大 场景：上传文件超过服务器限制（如 Nginx 的 client_max_body_size）

414 URI Too Long · URL 过长 场景：GET 请求把大量参数拼进 URL 导致超限，应改用 POST 请求体

415 Unsupported Media Type · 媒体类型不支持 场景：发送 XML 但接口只收 JSON，检查 Content-Type 是否正确

416 Range Not Satisfiable · 范围请求不可满足 场景：Range 请求的起止位置超出资源实际大小

417 Expectation Failed · 期望失败 场景：服务器无法满足 Expect: 100-continue 的要求

418 I'm a teapot · 我是一个茶壶 场景：1998 年愚人节彩蛋；有服务用它俏皮回应「我知道你在扫描我」，正式项目勿用

421 Misdirected Request · 请求被发错服务器 场景：HTTP/2 连接复用到了错误的主机（SNI 不匹配）

422 Unprocessable Entity · 语法对但语义错误 场景：表单校验失败（字段格式对但值不合法），RESTful API 高频使用

423 Locked · 资源被锁定 场景：WebDAV 资源被其他会话锁定，当前操作无法进行

425 Too Early · 请求过早 场景：重放保护：时间戳过早的请求可能属于重放攻击，拒绝处理

426 Upgrade Required · 需要升级协议 场景：要求客户端切换到 TLS/HTTP2/WebSocket 后再访问

428 Precondition Required · 需要前置条件 场景：要求请求带 If-Match 等条件头，防止「丢失更新」

429 Too Many Requests · 请求太频繁 场景：触发限流时返回，应带 Retry-After 头告知等待时间

431 Request Header Fields Too Large · 请求头过大 场景：Cookie 堆积过多撑爆请求头，清理站点 Cookie 后重试

451 Unavailable For Legal Reasons · 因法律原因不可用 场景：版权下架、监管合规屏蔽，如仓库被 DMCA 下架

💥 5xx 服务端错误（服务器处理时出了问题）

500 Internal Server Error · 服务器内部错误 场景：未捕获异常、代码 Bug、配置错误；最通用的服务端错误

501 Not Implemented · 功能未实现 场景：服务器不支持该 HTTP 方法，如只实现了 GET 的简易服务收到 POST

502 Bad Gateway · 网关错误 场景：Nginx 反代时后端（PHP-FPM/Node）崩溃或返回非法响应；排查后端进程与错误日志

503 Service Unavailable · 服务不可用 场景：服务器过载或维护中，可返回 Retry-After；负载均衡摘除节点时也用它

504 Gateway Timeout · 网关超时 场景：反代等待后端响应超时；重点查慢 SQL、外部接口卡死、上游超时配置

505 HTTP Version Not Supported · HTTP 版本不支持 场景：客户端使用了服务器不支持的 HTTP 版本

506 Variant Also Negotiates · 变体协商异常 场景：透明内容协商配置错误导致的内部错误，极少见到

507 Insufficient Storage · 存储不足 场景：WebDAV 写入时服务器磁盘空间不够

508 Loop Detected · 检测到无限循环 场景：WebDAV 绑定形成环，处理时触发了死循环保护

511 Network Authentication Required · 需要网络认证 场景：公共 WiFi 门户登录页劫持响应时使用，引导用户先完成网络认证

核心特性

5 大类 58 个常用状态码

含义 + 使用场景双栏说明

关键字即时搜索（支持中英文）

分类标签快速筛选

状态码一键复制

易混状态码对比讲解

支持黑夜模式与离线使用

状态码为什么总是记混？

日常开发里真正高频的状态码只有十几个，但一到排查线上问题，502 和 504 分不清、301 和 302 不知道该返回哪个、401 和 403 傻傻搞反的情况比比皆是。问题不在记性，而在状态码是按语义设计的，不是按数字：同为重定向，301/308 永久、302/307 临时，后者还严格保持请求方法；同为 5xx，502 是后端给了坏响应、504 是后端压根没响应。

这份速查表把 1xx 信息响应、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误共 58 个常用状态码整理成 5 大类，每个都写清「是什么」和「什么时候用」：断点续传对应 206、协商缓存命中对应 304、限流触发对应 429、PRG 模式跳转对应 303……遇到不确定的状态码，直接搜索数字或中英文关键词即可。

所有内容为静态文档，无任何网络请求，可离线使用。建议把 401/403、301/302/307/308、502/503/504 这三组易混组合重点看一遍，接口设计与线上排障时能少走很多弯路。

怎么用

按类别切换

点顶部「1xx 信息 / 2xx 成功 / 3xx 重定向 / 4xx 客户端 / 5xx 服务端」标签切换到对应类别，或点「全部」查看所有状态码。
搜索状态码

在搜索框输入数字（如 429）或中英文关键词（如 限流、timeout），列表会实时过滤出相关条目。
查看场景

每条记录分两栏：左边是含义速览，右边是「什么时候用」的真实场景说明。
复制状态码

点击条目右侧的「复制」按钮，状态码数字与英文名（如 429 Too Many Requests）即被复制。

使用技巧

401 与 403：401 是「不知道你是谁」（未登录/Token 失效），403 是「知道你是谁但不许你干这个」（权限不足）。
301 与 302：301 永久跳转会转移 SEO 权重，站点换域名、HTTP 迁 HTTPS 用它；302 临时跳转不转移权重。
302 与 307：302 历史实现上可能把 POST 变 GET；307 严格保持原请求方法与请求体，跨域 POST 跳转用它更安全。
502 与 504：502 说明网关收到了后端的非法响应或连接被拒（后端崩了）；504 说明后端在超时时间内没响应（后端太慢）。
触发 429 限流时应返回 Retry-After 响应头，告诉客户端等待多少秒再重试。
RESTful 接口设计：创建成功用 201 并带 Location 头；更新用 200 或 204；参数校验语义错误用 422 而非 400。
删除成功的推荐做法是返回 204（无返回体）或 200 + 说明，不要返回 404。

更新记录

v1.0 2026-09-16 首次上线：5 大类 58 个常用 HTTP 状态码速查、含义 + 使用场景双栏说明、关键字即时搜索、分类标签筛选、状态码一键复制。

常见问题

401 和 403 到底怎么区分？

401 Unauthorized 本意是「未认证」：客户端没有身份凭证或凭证无效/过期，应配合 WWW-Authenticate 响应头提示如何认证，客户端通常需要重新登录或刷新 Token。403 Forbidden 是「已认证但无权限」：服务器知道你是谁，但你的角色无权访问该资源，重新登录也没用。记法：401 不知道你是谁，403 知道你是谁但不许。

301、302、307、308 四个重定向怎么选？

按「永久还是临时 × 是否保持请求方法」两维选择：301 永久 + 可能改方法（历史原因 POST 可能被转成 GET）；308 永久 + 严格保持方法；302 临时 + 可能改方法；307 临时 + 严格保持方法。换域名、强制 HTTPS 用 301；登录后跳转、临时维护用 302；API 地址永久迁移用 308；POST 跨域临时跳转用 307。另外 303 专用于「POST 完成后跳结果页」（PRG 模式），明确要求改用 GET 访问。

为什么视频拖进度条会用到 206？

视频播放器拖动进度条时，会通过 Range: bytes=xxxx-yyyy 请求头向服务器只请求缺失的那一段数据，服务器返回 206 Partial Content 和对应的 Content-Range。这也是断点续传、大文件分片下载的原理。如果请求的范围超出了文件实际大小，服务器会返回 416 Range Not Satisfiable。

502、503、504 排查线上问题时分别意味着什么？

502：网关（如 Nginx）收到了后端的非法响应或连接被拒绝，通常是 PHP-FPM/Node 进程崩了、脚本 fatal error；503：服务过载或正在维护，负载均衡器把节点摘除时也会返回它，可带 Retry-After；504：网关在超时时间内没等到后端响应，通常是慢 SQL、外部接口卡死、超时配置过短。排查顺序：先看 502 的后端错误日志，504 则重点查慢查询与上游超时配置。

PUT/DELETE 成功后应该返回什么状态码？

推荐：PUT/PATCH 更新成功返回 200（带最新资源内容）或 204（无返回体）；DELETE 删除成功返回 204 或 200；POST 创建资源成功返回 201，并带 Location 头指向新资源地址。不要创建/更新成功还返回 201/200 之外让人误解的码，也不要用 404 表达「删过了再删一次」。

418 I'm a teapot 是干什么用的？

它来自 1998 年愚人节发布的 HTCPCP（超文本咖啡壶控制协议），字面意思是「我是一个茶壶，没法给你煮咖啡」。RFC 2324 之后它成了社区的著名彩蛋，没有正经语义，部分服务会故意返回 418 表示「我知道你在扫描我」。实际项目里不要使用它，面试聊资倒是很好用。

这份速查表能离线使用吗？

可以。点顶部「📥 下载离线版」会导出包含全部状态码的自包含 HTML 文件，不联网也能打开查阅。

💬 留言板 0

全部留言需审核通过后展示

💬

还没有留言，来抢沙发吧！

HTTP 状态码速查

📡 HTTP 状态码速查

💬 1xx 信息响应（服务器已收到请求，继续处理中）

✅ 2xx 成功（请求被成功接收并处理）

🔀 3xx 重定向（需要客户端进一步操作才能完成请求）

🚫 4xx 客户端错误（请求有误，客户端需要修改后重试）

💥 5xx 服务端错误（服务器处理时出了问题）

核心特性

状态码为什么总是记混？

怎么用

使用技巧

更新记录

常见问题

💬 留言板 0

留言已提交！

📡 HTTP 状态码速查

💬 1xx 信息响应（服务器已收到请求，继续处理中）

✅ 2xx 成功（请求被成功接收并处理）

🔀 3xx 重定向（需要客户端进一步操作才能完成请求）

🚫 4xx 客户端错误（请求有误，客户端需要修改后重试）

💥 5xx 服务端错误（服务器处理时出了问题）

核心特性

状态码为什么总是记混？

怎么用

使用技巧

更新记录

常见问题

💬 留言板 0

留言已提交！

🔗 相关工具推荐