免费 HTTP 状态码参考

用于 Expect: 100-continue 请求。服务器确认愿意在客户端发送正文前接收。在现代网络应用中很少见。

最常用于 WebSocket 升级 — 客户端请求 Upgrade: websocket，服务器响应 101 进行切换。

WebDAV 中间响应，用于在冗长操作期间防止客户端超时。已弃用 — 现代服务器不应发送。

让服务器在准备最终响应期间发送链接头 (预加载/预连接)，以便浏览器可以更快地开始获取关键资源。

标准成功响应。具体含义取决于 HTTP 方法：GET → 返回资源，POST/PUT → 操作完成。

常见于 POST 后。响应应包含指向新资源 URL 的 Location 头。

用于异步操作 — 服务器正在排队处理。客户端应轮询状态端点或稍后重新检查。

请求成功，但中介 (如缓存或转换代理) 改变了来自原始服务器的有效负载 — 例如重新压缩图像。在实践中很少见。

通常用于 DELETE 操作或不需要返回正文的 PUT 更新。客户端不应离开当前页面。

类似于 204，不返回正文 — 但另外告知客户端重置生成请求的表单或视图 (例如清空表单字段以供下一条输入)。

对 Range 请求的响应。由视频播放器和下载管理器使用，用于恢复中断的下载或流式传输大文件。

WebDAV：XML 正文独立报告多个子操作的结果 — 例如批量移动，其中某些项成功，其他项失败。

WebDAV：在 207 多状态响应内使用，以避免在绑定创建循环时重复列出同一集合的成员。

增量编码：服务器返回与以前版本的差异，而不是完整资源，节省带宽。极少实现。

服务器提供多个选项 (例如不同的格式或语言)，客户端应选择一个。很少使用，因为自动内容协商通常处理这个。

用于永久 URL 更改 — 搜索引擎将更新其索引。SEO 权重转移到新 URL。

表示重定向不是永久的。缓存不如 301 那样激进。用于诸如 '需要登录，重定向到 /login' 之类的事情。

在 POST 提交后使用 — 响应表示 '您的 POST 成功了，请查看此 GET URL 以获取结果'。浏览器始终 GET 新 URL。

对条件请求 (带有 If-None-Match 或 If-Modified-Since 头) 的响应。节省带宽 — 不返回正文。

如果原始请求是 POST，重定向也使用 POST。当方法保留重要时，307 是 302 的现代替代方案。

301 的现代替代方案，适用于希望 POST 请求在重定向后仍保持为 POST 的情况。

常见原因：正文中的 JSON 格式错误、无效的查询参数或缺少必需字段。检查请求正文和头。

客户端必须包含身份验证凭据 (Authorization 头、Cookie、令牌)。'Unauthorized' 是用词不当 — 它实际上意味着 '未认证'。

最初用于数字支付。现代用法：当用户超过其付费配额时，API 有时会返回 402。

与 401 不同 — 用户已登录，但其账户没有此资源的权限。检查角色/权限逻辑。

URL 错误、资源已删除或从未存在。服务器有时会返回 404 来隐藏 403 更准确的事实。

例如，对仅接受 POST 的端点的 GET 请求。响应应包含列出有效方法的 Allow 头。

客户端要求服务器无法满足的内容类型、语言或编码 (通过 Accept、Accept-Language、Accept-Encoding)。许多服务器跳过严格协商并返回默认值。

类似于 401，但由代理发出：客户端必须发送代理授权凭据。在具有身份验证代理的企业网络上很常见。

客户端发送请求体用时过长或保持连接空闲状态。请重试请求。

通常返回于并发编辑冲突或重复资源创建（例如，使用已存在的电子邮件创建用户）。

比 404 更强 — 服务器明确知道资源曾经存在但已被永久删除。搜索引擎会将其从索引中移除。

请求被拒绝，因为缺少 Content-Length 标头，服务器拒绝接收大小未知的请求体。请添加标头并重试。

在条件标头（如 If-Match 或 If-Unmodified-Since）验证失败时返回 — 通常为乐观锁定：自你的版本以来，其他人更改了资源。请重新获取并重试。

上传大文件时常见。服务器配置（nginx、apache）设置了最大请求体大小。请检查服务器配置。

通常由非常长的查询字符串引起（例如在 GET 中编码数据）。改用 POST 请求体，或者如果你可以控制服务器，提高服务器限制。

例如，向仅接受 application/json 的服务器发送 application/xml。请正确设置 Content-Type 标头。

Range 标头要求文件不具有的部分 — 例如，恢复下载超过文件末尾。响应应包含具有实际大小的 Content-Range。

在服务器不支持 Expect: 100-continue 时发送。某些客户端在大型 POST 上默认发送此标头；禁用它通常会解决错误。

1998 年的愚人节笑话（RFC 2324）。某些真实 API 用它来开玩笑或标记已弃用的端点。不用于生产。

常见于 HTTP/2 连接重用：请求到达未为目标主机名配置的服务器。客户端应在新连接上重试。

例如，JSON 解析正确但缺少必需字段，或字段值超出范围。在 REST API 验证响应中常见。

WebDAV：源或目标资源被另一个客户端锁定，因此操作无法进行。等待锁释放或使用正确的令牌中断它。

WebDAV：在一系列相关操作中，较早的操作失败，因此此操作未执行。查看较早的失败以找到根本原因。

与 TLS 1.3 0-RTT（早期数据）相关：服务器将不会冒可能重放请求的风险。客户端应在握手完成后重试。

服务器拒绝在当前协议上服务请求，但在升级后会 — 响应包含命名所需协议的 Upgrade 标头。

服务器要求条件标头（如 If-Match）以防止丢失更新冲突。获取资源、捕获其 ETag，并使用 If-Match 重新发送。

放慢速度。响应应包含 Retry-After 标头，指示何时重试。常见于具有请求配额的 API。

单个标头或总标头大小超过限制 — 最常由过大的 cookies 引起。清除 cookies 或减少应用在其中存储的内容。

资源因法律原因被阻止 — 审查、法庭命令或地区法规。这个数字是对小说《华氏 451 度》的致敬。

服务器端错误的通用包罗万象。检查服务器日志以找到实际原因：未处理的异常、数据库错误等。

例如，服务器不识别 HTTP 方法。实际上很少见 — 更常见的是看到 405。

在微服务架构中常见。你的负载均衡器或反向代理从后端服务获得了格式错误的响应。

要么正在维护，要么过载。响应应包含 Retry-After 标头。通常在部署期间返回。

后端服务响应速度不够快。检查上游服务健康状况和超时配置。

请求的 HTTP 主要版本不受服务器支持。在现代客户端中几乎从不出现。

透明内容协商陷入循环：所选变体本身配置为协商。表示服务器配置错误。

WebDAV 特有，但有时由常规服务器使用。意味着服务器由于存储限制而无法保存请求。

WebDAV：处理 Depth: infinity 请求时进入循环（例如循环绑定）。操作已终止。

来自已过时的 HTTP 扩展框架：服务器在满足请求之前需要更多信息。实际上在现代网络上未使用。

被强制网络门户（酒店/机场 WiFi）使用，表示用户必须先登录网络，然后才能访问外部站点。