Werkzeug wird geladen…

Erklärung

Wird geladen…

HTTP-StatuscodesNeu

Alle Statuscodes aus RFC 9110 plus Erweiterungen und die nicht standardisierten von nginx und Cloudflare, insgesamt 72: jeweils Bedeutung, Auftreten, Behandlung in Frontend und Backend sowie typische Fehlverwendung, dazu sieben Gruppen leicht verwechselbarer Codes; durchsuchbar, kopierbar, als Favorit speicherbar

Dieses Werkzeug ist noch nicht vollständig übersetzt; einige Inhalte nutzen die Ausgangssprache oder die Rückfallsprache.

Nur häufige 18 CodesGesamt 72 Codes

Leicht verwechselbare Statuscodes

401 vs 403：你是谁 vs 你不能

401没有有效凭证；带 WWW-Authenticate；前端应跳登录 / 刷 token
403已认证但无权限；重新登录也没用；前端提示无权限

301 / 302 / 307 / 308：永久还是临时、方法保不保

301永久，浏览器缓存，POST 可能变 GET
302临时，不缓存，POST 可能变 GET
307临时，保持方法与请求体
308永久，保持方法与请求体

400 vs 422：读不懂 vs 读懂了但不合理

400JSON 解析失败、缺参数、类型错
422格式对但业务校验失败（库存不足、密码太弱）

404 vs 410：不知道 vs 确定没了

404找不到，不说明是否永久；列表为空不是 404
410曾经有、永久删除；搜索引擎更快移除

502 / 503 / 504：网关看到了什么

502上游连不上或回了不合法响应（应用挂了）
503服务主动说「忙 / 维护」，带 Retry-After
504上游太慢，网关等超时（慢查询、长任务）

200 / 201 / 202 / 204：成功了什么

200成功，有结果
201创建了新资源，带 Location
202收到了，稍后处理（异步）
204成功，没内容（删除、更新）

429 vs 503：慢点 vs 等等

429你（这个客户端）请求太多，按 Retry-After 退避
503服务整体不可用，与你的频率无关

1xx 信息 4 Codes

请求已收到，继续处理；浏览器几乎不会把它暴露给页面脚本。

100Continue继续
请求头已收到，客户端可以继续发送请求体。
RFC 9110 §15.2.1
Wann er auftritt
客户端发送大请求体前带 Expect: 100-continue，服务器同意时先回 100。
Frontend / Client
浏览器自动处理，fetch/XHR 看不到。curl 上传大文件时会自动用。
Backend / Server
收到 Expect: 100-continue 且请求头没问题就回 100；有问题（如 413）直接回最终状态，省一次上传。
101Switching Protocols切换协议
服务器同意按 Upgrade 头切换到另一个协议。
RFC 9110 §15.2.2
Wann er auftritt
WebSocket 握手成功：客户端 Upgrade: websocket，服务器回 101 后连接变成 WebSocket。
Frontend / Client
new WebSocket(url) 时由浏览器完成，握手失败会在 onerror 里体现。
Backend / Server
校验 Sec-WebSocket-Key 后回 101 + Sec-WebSocket-Accept；反向代理要放行 Upgrade 与 Connection 头。
102Processing处理中
服务器已收到并在处理请求，但尚无最终响应。
RFC 2518（WebDAV，已废弃）
Wann er auftritt
老 WebDAV 服务器处理耗时操作时防止客户端超时。
Frontend / Client
现代浏览器忽略；几乎不会遇到。
Backend / Server
不要再用；长任务改为 202 + 轮询或 103。
103Early Hints早期提示
在最终响应之前先发一部分头（主要是 Link: preload），让浏览器提前加载资源。
RFC 8297
Wann er auftritt
服务器要花几百毫秒生成 HTML，先告诉浏览器 CSS/JS 的地址。
Frontend / Client
Chrome/Edge/Firefox 支持；页面脚本不可见，收益体现在瓶颈资源更早开始下载。
Backend / Server
Nginx 1.29+/Cloudflare/Fastly 支持；只对 GET 且 HTTP/2、HTTP/3 有意义。

2xx 成功 10 Codes

请求被成功接收、理解并处理。

200OK成功
Häufig
请求成功，响应体里是请求的资源或操作结果。
RFC 9110 §15.3.1
Wann er auftritt
GET 拿到页面/数据、POST 处理完并返回结果。
Frontend / Client
fetch 的 response.ok 为 true；仍需按业务字段判断是否真正成功。
Backend / Server
最常见的成功码；GET 返回资源本体，POST 返回处理结果（新建资源优先用 201）。
Häufige Fehlverwendung
业务失败也返回 200 + {"code": 500}：监控、缓存、CDN 都看不出错误。HTTP 状态码和业务码应一致。
201Created已创建
请求成功且创建了新资源。
RFC 9110 §15.3.2
Wann er auftritt
POST /users 创建了一个用户。
Frontend / Client
读 Location 头或响应体拿到新资源地址/ID，跳到详情页。
Backend / Server
带 Location: /users/123 指向新资源；响应体可返回新资源的表示。
Häufige Fehlverwendung
创建成功却返回 200 没带 Location，客户端得再查一遍。
202Accepted已接受
请求已接受但尚未处理完，是异步任务的回执。
RFC 9110 §15.3.3
Wann er auftritt
提交视频转码、批量导出、发送邮件等后台任务。
Frontend / Client
拿到任务 ID 后轮询状态接口或等 WebSocket 通知，不要把它当作「已完成」。
Backend / Server
返回任务 ID 与查询地址（Location 或响应体），处理结果在另一个接口给出。
203Non-Authoritative Information非权威信息
响应成功，但内容被中间代理修改过。
RFC 9110 §15.3.4
Wann er auftritt
代理对源站 200 响应做了转换（如压缩图片、注入脚本）。
Frontend / Client
当 200 处理即可。
Backend / Server
源站不主动返回；代理层转换内容时应改为 203。
204No Content无内容
Häufig
成功，但没有响应体。
RFC 9110 §15.3.5
Wann er auftritt
DELETE 成功、PUT 更新成功、保存偏好设置这类不需要返回内容的操作。
Frontend / Client
response.json() 会抛错（body 为空）——先判断 status === 204 再解析。
Backend / Server
不要带响应体（有些框架会自动去掉）；Content-Length 应为 0 或省略。
Häufige Fehlverwendung
DELETE 返回 200 + 空对象 {}，或 204 却带了 body。
205Reset Content重置内容
成功，且要求客户端重置「文档视图」（如清空表单）。
RFC 9110 §15.3.6
Wann er auftritt
几乎没人用；语义上适合「提交后清空表单准备下一条」。
Frontend / Client
浏览器不会自动清表单，需自行处理。
Backend / Server
一般用 204 代替。
206Partial Content部分内容
返回的是资源的一部分（Range 请求成功）。
RFC 9110 §15.3.7
Wann er auftritt
视频拖动进度条、断点续传、大文件分块下载。
Frontend / Client
<video> 与下载器自动处理；自己实现分块下载时要解析 Content-Range。
Backend / Server
支持 Range 头，回 206 + Content-Range: bytes 0-1023/146515 + Accept-Ranges: bytes；不支持时忽略 Range 回 200 整体。
207Multi-Status多状态
响应体是 XML，里面每个子资源各有自己的状态码。
RFC 4918（WebDAV）
Wann er auftritt
WebDAV 批量操作（如 PROPFIND 列目录、批量删除）。
Frontend / Client
WebDAV 客户端解析；普通 Web 应用不会遇到。
Backend / Server
仅 WebDAV 服务用；REST 批量接口通常用 200 + 逐项结果数组。
208Already Reported已报告
207 响应里，同一个资源已在前面报告过，不再重复。
RFC 5842（WebDAV）
Wann er auftritt
WebDAV 绑定（binding）导致同一资源出现多次时。
Frontend / Client
WebDAV 客户端内部处理。
Backend / Server
仅 WebDAV。
226IM Used已使用 IM
服务器对当前实例应用了「实例操作」（增量编码）返回差异。
RFC 3229
Wann er auftritt
Delta encoding，实际部署极少。
Frontend / Client
基本不会遇到。
Backend / Server
基本不用。

3xx 重定向 9 Codes

需要客户端进一步动作（通常是换个地址再请求）才能完成。

300Multiple Choices多种选择
资源有多个表示，请客户端选一个。
RFC 9110 §15.4.1
Wann er auftritt
内容协商无法自动决定（多语言/多格式）时列出选项。
Frontend / Client
浏览器不会自动选；实践中极少见。
Backend / Server
通常直接用 Accept-Language 等做协商返回 200，不返回 300。
301Moved Permanently永久移动
Häufig
资源永久搬到 Location 指向的新地址，以后都用新地址。
RFC 9110 §15.4.2
Wann er auftritt
http→https、旧域名→新域名、带/不带 www、URL 结构改版。
Frontend / Client
浏览器自动跟随并**缓存**这个跳转（下次直接去新地址）；fetch 默认 follow，response.redirected 为 true。
Backend / Server
带 Location；SEO 权重会转移到新地址。注意：POST 被 301 后多数客户端会改成 GET。
Häufige Fehlverwendung
临时活动页用了 301，活动结束后浏览器仍缓存旧跳转，改不回来；临时跳转用 302/307。
302Found临时移动
Häufig
资源暂时在别处，下次仍请求原地址。
RFC 9110 §15.4.3
Wann er auftritt
登录后跳回来源页、A/B 测试、临时维护页。
Frontend / Client
浏览器自动跟随、不缓存；POST 会被大多数客户端改成 GET 再请求（历史行为，规范已承认）。
Backend / Server
需要保持方法与请求体时用 307。
Häufige Fehlverwendung
用 302 做永久改版跳转，搜索引擎不会传递权重；应该用 301/308。
303See Other查看其他位置
请用 GET 去 Location 看结果（与当前请求方法无关）。
RFC 9110 §15.4.4
Wann er auftritt
POST 表单提交后跳到结果页（Post/Redirect/Get 模式，防止刷新重复提交）。
Frontend / Client
浏览器自动用 GET 请求 Location。
Backend / Server
表单提交成功后 303 + Location: /orders/123，比 302 语义更明确。
304Not Modified未修改
Häufig
资源没变，用你缓存里的那份。
RFC 9110 §15.4.5
Wann er auftritt
浏览器带 If-None-Match（ETag）或 If-Modified-Since 条件请求，资源未变。
Frontend / Client
浏览器透明处理，fetch 看到的是 200（来自缓存）；DevTools Network 里显示 304。
Backend / Server
比较 ETag / Last-Modified，一致就回 304 且不带响应体；这是节省带宽而不是节省请求数。
Häufige Fehlverwendung
以为 304 能省请求——省的是传输，请求仍会到服务器。想省请求用 Cache-Control: max-age。
305Use Proxy使用代理
必须通过 Location 指定的代理访问。
RFC 9110 §15.4.6（已弃用）
Wann er auftritt
因安全问题已弃用，现代浏览器忽略。
Frontend / Client
忽略。
Backend / Server
不要用。
306(Unused)（未使用）
曾在草案中表示「切换代理」，现已保留不用。
RFC 9110 §15.4.7
Wann er auftritt
不会出现。
Frontend / Client
—
Backend / Server
不要用。
307Temporary Redirect临时重定向（保持方法）
Häufig
临时跳转，且客户端必须用**同样的方法和请求体**重发。
RFC 9110 §15.4.8
Wann er auftritt
POST 接口临时迁移、HSTS 内部跳转（浏览器把 http 改成 https 时显示 307 Internal Redirect）。
Frontend / Client
浏览器自动重发同方法请求；跨域时要注意 CORS 预检。
Backend / Server
接口级临时跳转用它而不是 302，避免 POST 变 GET。
308Permanent Redirect永久重定向（保持方法）
永久跳转，且保持方法与请求体（301 的严格版）。
RFC 9110 §15.4.9
Wann er auftritt
API 端点永久迁移，POST/PUT 也要正确到达新地址。
Frontend / Client
浏览器自动跟随并缓存。
Backend / Server
接口永久迁移用 308，网页永久迁移 301 也可以。

4xx 客户端错误 29 Codes

请求本身有问题：语法、鉴权、资源不存在、频率过高……重试同样的请求不会成功。

400Bad Request请求错误
Häufig
服务器无法理解请求：语法错、参数缺失/格式错、JSON 解析失败。
RFC 9110 §15.5.1
Wann er auftritt
请求体不是合法 JSON、必填参数没传、日期格式不对、请求头畸形。
Frontend / Client
读响应体里的错误详情提示用户或修正请求；重试同样的请求没有意义。
Backend / Server
返回结构化错误（字段名 + 原因），不要只给 "Bad Request"。语义正确但校验失败可用 422。
Häufige Fehlverwendung
把所有客户端错误都归到 400：鉴权失败应是 401/403，资源不存在应是 404。
401Unauthorized未认证
Häufig
缺少或无效的身份凭证——「你是谁？」（名字叫 Unauthorized，实际含义是 Unauthenticated）。
RFC 9110 §15.5.2
Wann er auftritt
没带 token、token 过期、密码错误、Basic 认证失败。
Frontend / Client
清掉本地登录态、跳转登录页或静默刷新 token 后重试一次；不要循环重试。
Backend / Server
必须带 WWW-Authenticate 头说明认证方式（如 Bearer realm="api"）；token 过期与无效可在响应体里区分。
Häufige Fehlverwendung
已登录但没权限也返回 401，导致前端反复跳登录页——那是 403。
402Payment Required需要付费
为将来的数字支付保留，规范未定义具体语义。
RFC 9110 §15.5.3（保留）
Wann er auftritt
一些 API（如 Stripe、部分 AI 服务）用它表示余额不足/超出免费额度。
Frontend / Client
按该服务文档处理，通常是引导充值/升级。
Backend / Server
可以用，但语义是自定义的，文档要写清。
403Forbidden禁止访问
Häufig
服务器知道你是谁，但你没有权限——「你不能」。重新认证也没用。
RFC 9110 §15.5.4
Wann er auftritt
普通用户访问管理员接口、IP 被封、目录禁止列出、WAF 拦截、S3 对象不公开。
Frontend / Client
提示无权限，不要跳登录页（用户已登录）；可提供申请权限入口。
Backend / Server
不想泄露资源存在性时可返回 404 代替；WAF/防火墙拦截也常用 403。
Häufige Fehlverwendung
与 401 混用；把「未登录」返回 403 会让前端无法自动跳登录。
404Not Found未找到
Häufig
服务器找不到请求的资源，且不说明是临时还是永久。
RFC 9110 §15.5.5
Wann er auftritt
URL 打错、资源已删除、路由未配置、SPA 刷新子路由未回退到 index.html。
Frontend / Client
显示 404 页并给出返回/搜索入口；SPA 需要服务器把未知路径回退到 index.html（或预渲染每个路由）。
Backend / Server
资源确定永久删除用 410 更准确；不想暴露存在性的资源也可用 404 代替 403。
Häufige Fehlverwendung
接口把「查询结果为空」返回 404——列表为空应是 200 + []；只有「这个 ID 的资源不存在」才是 404。
405Method Not Allowed方法不允许
资源存在，但不支持这个 HTTP 方法。
RFC 9110 §15.5.6
Wann er auftritt
对只读接口发 POST、静态文件服务器收到 PUT、路由只注册了 GET。
Frontend / Client
检查请求方法；读 Allow 头看支持哪些。
Backend / Server
必须带 Allow: GET, HEAD 头列出支持的方法。
406Not Acceptable不可接受
服务器没有能满足 Accept / Accept-Language 等要求的表示。
RFC 9110 §15.5.7
Wann er auftritt
客户端 Accept: application/xml 但服务只出 JSON。
Frontend / Client
放宽 Accept 或改请求格式。
Backend / Server
实践中多数服务忽略 Accept 直接返回默认格式；严格协商才返回 406。
407Proxy Authentication Required需要代理认证
需要先向代理服务器认证（401 的代理版）。
RFC 9110 §15.5.8
Wann er auftritt
公司网络代理要求账号密码。
Frontend / Client
浏览器弹出代理认证框；应用层通常处理不了。
Backend / Server
代理返回，带 Proxy-Authenticate 头。
408Request Timeout请求超时
服务器等请求等太久（客户端迟迟没发完）。
RFC 9110 §15.5.9
Wann er auftritt
慢网络下上传中断、HTTP 保活连接空闲太久被服务器关闭。
Frontend / Client
可以安全重试整个请求（幂等性由方法决定）。
Backend / Server
发 408 时应带 Connection: close；Nginx 用 client_body_timeout 等控制。
409Conflict冲突
Häufig
请求与资源当前状态冲突，用户可能通过修改请求解决。
RFC 9110 §15.5.10
Wann er auftritt
注册已存在的用户名、乐观锁版本号不匹配、重复创建同名资源、Git 推送被拒的 HTTP 层。
Frontend / Client
提示冲突原因（如「用户名已被占用」）；乐观锁场景重新拉取最新数据后让用户决定。
Backend / Server
响应体说明冲突点；唯一约束冲突用 409 而不是 400 或 500。
410Gone已删除
资源曾经存在，现在永久移除，且没有转发地址。
RFC 9110 §15.5.11
Wann er auftritt
下架的商品页、删除的帖子、停用的 API 版本。
Frontend / Client
当作最终状态，不再重试；SEO 上搜索引擎会更快移除索引。
Backend / Server
明确知道永久删除时用 410 而不是 404。
411Length Required需要 Content-Length
服务器要求请求带 Content-Length。
RFC 9110 §15.5.12
Wann er auftritt
用分块传输编码发请求体而服务器不接受。
Frontend / Client
大多数客户端自动加；流式上传到不支持 chunked 的服务器时会遇到。
Backend / Server
尽量支持 Transfer-Encoding: chunked。
412Precondition Failed前置条件失败
请求头里的条件（If-Match、If-Unmodified-Since）不满足。
RFC 9110 §15.5.13
Wann er auftritt
用 ETag 做乐观并发控制：If-Match 的版本已过期。
Frontend / Client
重新 GET 拿最新 ETag，提示用户数据已被他人修改。
Backend / Server
实现 If-Match 校验，冲突时回 412（业务层冲突也可用 409）。
413Content Too Large请求体过大
Häufig
请求体超过服务器允许的大小。
RFC 9110 §15.5.14（旧名 Payload Too Large）
Wann er auftritt
上传大文件、Nginx client_max_body_size 默认 1M、云函数请求体上限。
Frontend / Client
上传前检查文件大小并提示上限；大文件走分片上传。
Backend / Server
在网关/Nginx 层配置上限并在文档里写明；响应可带 Retry-After。
414URI Too LongURI 过长
URL 太长服务器拒绝处理。
RFC 9110 §15.5.15
Wann er auftritt
GET 请求把大量数据塞进查询串（如几千个 ID）。
Frontend / Client
改用 POST 传参。
Backend / Server
Nginx large_client_header_buffers 可调，但更该改接口设计。
415Unsupported Media Type不支持的媒体类型
请求体的格式（Content-Type）服务器不支持。
RFC 9110 §15.5.16
Wann er auftritt
接口要 application/json 却收到 form-data；上传了不允许的文件类型。
Frontend / Client
检查 Content-Type 头是否与实际 body 一致。
Backend / Server
在响应体说明支持的类型。
416Range Not Satisfiable范围无法满足
Range 头请求的字节范围超出资源大小。
RFC 9110 §15.5.17
Wann er auftritt
断点续传时本地已下载的字节数 ≥ 文件长度（文件在服务端变小了）。
Frontend / Client
丢弃本地缓存重新下载。
Backend / Server
带 Content-Range: bytes */146515 告知实际大小。
417Expectation Failed期望失败
无法满足 Expect 头的要求。
RFC 9110 §15.5.18
Wann er auftritt
客户端 Expect: 100-continue 而中间代理/老服务器不支持。
Frontend / Client
curl 遇到时可加 -H "Expect:" 关掉。
Backend / Server
尽量支持 Expect: 100-continue。
418I'm a teapot我是茶壶
1998 年愚人节 RFC 的玩笑，不应在真实 HTTP 里使用。
RFC 2324（愚人节 RFC）；RFC 9110 标记为未使用
Wann er auftritt
某些网站把它当彩蛋或用于拦截爬虫。
Frontend / Client
当作未知 4xx。
Backend / Server
别用于生产语义。
421Misdirected Request请求被误导
请求发到了无法为该 authority（域名）提供响应的服务器。
RFC 9110 §15.5.20
Wann er auftritt
HTTP/2 连接复用把请求发到了不该处理该域名的连接；SNI 与 Host 不匹配。
Frontend / Client
浏览器会用新连接重试。
Backend / Server
多域名证书 + HTTP/2 部署时确保每个域名都能被同一后端处理。
422Unprocessable Content无法处理的内容
Häufig
请求语法正确、格式也对，但语义上无法处理（业务校验失败）。
RFC 9110 §15.5.21（旧名 Unprocessable Entity）
Wann er auftritt
邮箱格式对但域名不存在、下单数量超过库存、密码不满足复杂度。
Frontend / Client
把字段级错误显示到对应输入框旁。
Backend / Server
返回字段名 → 错误列表的结构；与 400 的分工：400 是「读不懂」，422 是「读懂了但不合理」。
423Locked已锁定
资源被锁定。
RFC 4918（WebDAV）
Wann er auftritt
WebDAV 文件被他人编辑锁定。
Frontend / Client
WebDAV 客户端提示。
Backend / Server
仅 WebDAV；REST 场景一般用 409 或 403。
424Failed Dependency依赖失败
因为前一个依赖操作失败，本操作也失败。
RFC 4918（WebDAV）
Wann er auftritt
WebDAV 批量操作。
Frontend / Client
WebDAV 客户端处理。
Backend / Server
仅 WebDAV。
425Too Early过早
服务器不愿处理可能被重放的请求（TLS 1.3 0-RTT 早期数据）。
RFC 8470
Wann er auftritt
启用 TLS 1.3 0-RTT 时，非幂等请求在早期数据里发送。
Frontend / Client
浏览器自动在完整握手后重试。
Backend / Server
对非幂等请求拒绝 0-RTT 数据。
426Upgrade Required需要升级协议
服务器拒绝在当前协议上处理，要求切换到 Upgrade 头指定的协议。
RFC 9110 §15.5.22
Wann er auftritt
要求客户端改用 TLS 或更高 HTTP 版本。
Frontend / Client
按 Upgrade 头重连。
Backend / Server
带 Upgrade: TLS/1.3, HTTP/1.1 与 Connection: Upgrade。
428Precondition Required需要前置条件
服务器要求请求必须带条件头（如 If-Match），防止「丢失更新」。
RFC 6585
Wann er auftritt
API 强制乐观并发控制：没带 If-Match 的 PUT 被拒。
Frontend / Client
先 GET 取 ETag，再带 If-Match 更新。
Backend / Server
在响应体说明需要哪个条件头。
429Too Many Requests请求过多
Häufig
在给定时间内发了太多请求（限流）。
RFC 6585
Wann er auftritt
接口频率限制、登录尝试过多、爬虫被限速、AI API 超出每分钟配额。
Frontend / Client
读 Retry-After 头（秒数或日期）后指数退避重试；给用户「稍后再试」提示；不要立刻重试。
Backend / Server
带 Retry-After 与 RateLimit-* 头（RateLimit-Limit / Remaining / Reset）；按用户/IP/API key 计数。
Häufige Fehlverwendung
限流返回 403 或 503，客户端无法区分是权限问题还是该等一会。
431Request Header Fields Too Large请求头过大
请求头（总和或单个）太大。
RFC 6585
Wann er auftritt
Cookie 堆积过多、超长 Authorization 头、Referer 过长。
Frontend / Client
清理 Cookie；检查是否把大数据放进了头里。
Backend / Server
Nginx large_client_header_buffers、Node --max-http-header-size 可调。
451Unavailable For Legal Reasons因法律原因不可用
因法律要求（版权、政府命令）拒绝提供资源。编号致敬《华氏 451》。
RFC 7725
Wann er auftritt
按地区屏蔽内容、DMCA 下架。
Frontend / Client
展示说明，无法绕过。
Backend / Server
可带 Link 头指向拦截方说明。

5xx 服务器错误 11 Codes

服务器知道自己出错或无法完成合法请求；稍后重试可能成功。

500Internal Server Error服务器内部错误
Häufig
服务器遇到了意料之外的情况，无法完成请求。
RFC 9110 §15.6.1
Wann er auftritt
未捕获异常、数据库连接失败、空指针、配置错误。
Frontend / Client
提示「服务暂时不可用」，可以有限次重试（幂等请求）；上报错误 ID 方便排查。
Backend / Server
记录完整堆栈，响应体只给错误 ID 不给堆栈；能识别的错误用更具体的码（400/409/503）。
Häufige Fehlverwendung
业务校验失败抛异常导致 500，其实应是 400/422。
501Not Implemented未实现
服务器不支持完成请求所需的功能（通常是不认识的方法）。
RFC 9110 §15.6.2
Wann er auftritt
发了服务器不认识的 HTTP 方法（如自定义方法）。
Frontend / Client
检查方法名。
Backend / Server
与 405 的区别：405 是「这个资源不允许该方法」，501 是「服务器整体不认识该方法」。
502Bad Gateway网关错误
Häufig
作为网关/代理的服务器从上游收到了无效响应。
RFC 9110 §15.6.3
Wann er auftritt
Nginx 后面的应用进程挂了或没启动、上游返回了不合法的 HTTP、容器还没就绪。
Frontend / Client
提示服务不可用并稍后重试；这不是前端能修的。
Backend / Server
查上游是否存活（应用日志、进程、端口）；Nginx error.log 会写 connect() failed 或 upstream prematurely closed。
Häufige Fehlverwendung
与 503/504 混淆：502 = 上游回了坏东西或连不上，503 = 服务主动说忙，504 = 上游超时没回。
503Service Unavailable服务不可用
Häufig
服务器暂时无法处理（过载或维护），通常是临时的。
RFC 9110 §15.6.4
Wann er auftritt
计划维护、流量洪峰、依赖服务熔断、健康检查失败被摘流量。
Frontend / Client
读 Retry-After 后重试；显示维护提示。
Backend / Server
维护时返回 503 + Retry-After，搜索引擎会稍后再来而不是降权；过载保护也用它。
504Gateway Timeout网关超时
Häufig
网关/代理等上游响应超时。
RFC 9110 §15.6.5
Wann er auftritt
接口执行太慢超过 Nginx proxy_read_timeout（默认 60s）、云函数超时、数据库慢查询。
Frontend / Client
长任务改为异步（202 + 轮询）；重试前确认操作幂等。
Backend / Server
优化慢接口或改异步；临时可调大 proxy_read_timeout，但那是止痛不是治病。
505HTTP Version Not SupportedHTTP 版本不支持
服务器不支持请求使用的 HTTP 主版本。
RFC 9110 §15.6.6
Wann er auftritt
极少见；老服务器收到 HTTP/2 明文请求等。
Frontend / Client
客户端降级协议。
Backend / Server
—
506Variant Also Negotiates变体也在协商
内容协商配置错误导致循环。
RFC 2295
Wann er auftritt
透明内容协商配置错误。
Frontend / Client
基本不会遇到。
Backend / Server
检查协商配置。
507Insufficient Storage存储空间不足
服务器无法存储完成请求所需的内容。
RFC 4918（WebDAV）
Wann er auftritt
WebDAV 上传时服务器磁盘满；部分云存储也用。
Frontend / Client
提示空间不足。
Backend / Server
仅 WebDAV 语义；REST 可用 413 或 503 视情况。
508Loop Detected检测到循环
处理请求时检测到无限循环。
RFC 5842（WebDAV）
Wann er auftritt
WebDAV 绑定成环。
Frontend / Client
—
Backend / Server
仅 WebDAV。
510Not Extended未扩展
请求需要进一步扩展才能被处理。
RFC 2774（历史）
Wann er auftritt
几乎不用。
Frontend / Client
—
Backend / Server
—
511Network Authentication Required需要网络认证
客户端需要先通过网络层认证（强制门户）才能上网。
RFC 6585
Wann er auftritt
连上机场/酒店 Wi-Fi 还没登录门户时，任何 HTTP 请求都被劫持到登录页。
Frontend / Client
检测到 511 时提示用户打开门户登录；不要把劫持页当成正常响应缓存。
Backend / Server
强制门户设备返回，普通站点不返回。

Nicht standardisierte Codes (nginx / Cloudflare) 9 Codes

Diese Codes stehen in keiner RFC und tauchen nur in Logs bestimmter Server oder auf CDN-Fehlerseiten auf; kennt man sie, spart das viel Fehlersuche.

444No Response无响应（nginx）
Nicht standardisiert
Nginx 直接关闭连接、不发任何响应；只出现在 Nginx 日志里。
nginx 私有
Wann er auftritt
配置 return 444 拒绝恶意请求或未知 Host。
Frontend / Client
浏览器看到的是连接被重置。
Backend / Server
用于 default_server 拦截无 Host 的扫描流量。
499Client Closed Request客户端关闭请求（nginx）
Nicht standardisiert
服务器还没响应，客户端就断开了；只出现在 Nginx 日志。
nginx 私有
Wann er auftritt
用户刷新/离开页面、前端 fetch 设了较短的 timeout 并 abort、上游太慢客户端先放弃。
Frontend / Client
大量 499 说明接口太慢或前端超时设得太短。
Backend / Server
查上游耗时；499 不是服务器错误，但常是 504 的前兆。
520Web Server Returned an Unknown Error源站返回未知错误（Cloudflare）
Nicht standardisiert
源站给 Cloudflare 的响应是空的、格式不对或超出头大小限制。
Cloudflare 私有
Wann er auftritt
源站崩溃、返回超过 16 KB 的响应头、连接被重置。
Frontend / Client
—
Backend / Server
查源站日志与响应头大小；Cloudflare 文档列出全部原因。
521Web Server Is Down源站宕机（Cloudflare）
Nicht standardisiert
Cloudflare 连不上源站（TCP 连接被拒）。
Cloudflare 私有
Wann er auftritt
源站进程没启动、防火墙没放行 Cloudflare IP。
Frontend / Client
—
Backend / Server
确认源站监听且放行 Cloudflare IP 段。
522Connection Timed Out连接超时（Cloudflare）
Nicht standardisiert
Cloudflare 向源站发起 TCP 连接超时。
Cloudflare 私有
Wann er auftritt
源站防火墙丢包、源站过载不接受新连接。
Frontend / Client
—
Backend / Server
检查防火墙与源站负载。
523Origin Is Unreachable源站不可达（Cloudflare）
Nicht standardisiert
Cloudflare 无法路由到源站（DNS 或网络路由问题）。
Cloudflare 私有
Wann er auftritt
源站 IP 配错、源站 DNS 解析失败。
Frontend / Client
—
Backend / Server
检查 Cloudflare DNS 记录指向的 IP。
524A Timeout Occurred源站响应超时（Cloudflare）
Nicht standardisiert
TCP 已连上，但源站在 100 秒内没有返回 HTTP 响应。
Cloudflare 私有
Wann er auftritt
接口执行超过 100 秒（免费/Pro 计划的上限）。
Frontend / Client
长任务改异步。
Backend / Server
优化慢接口或改异步；Enterprise 可调超时。
525SSL Handshake FailedSSL 握手失败（Cloudflare）
Nicht standardisiert
Cloudflare 与源站的 TLS 握手失败。
Cloudflare 私有
Wann er auftritt
源站没有有效证书却选了 Full (strict)、源站不支持 SNI。
Frontend / Client
—
Backend / Server
给源站装证书（Cloudflare Origin CA 即可）或调整 SSL 模式。
526Invalid SSL Certificate源站证书无效（Cloudflare）
Nicht standardisiert
Full (strict) 模式下源站证书过期、自签或域名不匹配。
Cloudflare 私有
Wann er auftritt
源站证书过期。
Frontend / Client
—
Backend / Server
更新源站证书。