差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 代码术语:404_303_这些是什么 [2026/10/14 16:46] – 创建 张叶安 | 代码术语:404_303_这些是什么 [2026/10/16 12:02] (当前版本) – 思维导图新增「000 不是状态码」分支 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 404、303 这些是什么 ====== |
| + | |||
| + | 第一次看到 '' | ||
| + | |||
| + | <code http> | ||
| + | HTTP/1.1 404 Not Found | ||
| + | Content-Type: | ||
| + | </ | ||
| + | |||
| + | 下面按「先看懂数字本身,再挑出 404 和 303 两个最常被问到的细讲」的顺序展开。 | ||
| + | |||
| + | ===== 一、三位数的读法 ===== | ||
| + | |||
| + | ^ 首位 ^ 大类 ^ 一句话 ^ 常见成员 ^ | ||
| + | | 1xx | 信息性 Informational | 请求收到了,还在处理,先别急 | 100 Continue、101 Switching Protocols、103 Early Hints | | ||
| + | | 2xx | 成功 Success | 事情办成了 | 200 OK、201 Created、204 No Content、206 Partial Content | | ||
| + | | 3xx | 重定向 Redirection | 你要的东西不在这儿,去别处拿 | 301、302、**303**、304、307、308 | | ||
| + | | 4xx | 客户端错误 Client Error | 你这边有问题,我处理不了 | 400、**404**、401、403、405、409、422、429 | | ||
| + | | 5xx | 服务端错误 Server Error | 我这边出问题了,不是你的错 | 500、502、503、504 | | ||
| + | |||
| + | 两条实战口径: | ||
| + | |||
| + | * **4xx 和 5xx 的区分决定了谁该去修。** 4xx 意味着「同样的请求再发一次也没用,除非先改请求」;5xx 是服务端故障,重试往往有意义。 | ||
| + | * **状态码是给程序看的,不是给人看的。** 前端、网关、缓存、爬虫都靠它做分支判断,所以别用 200 包着一个 '' | ||
| + | |||
| + | ===== 二、000:不是状态码,而是「没拿到状态码」 ===== | ||
| + | |||
| + | 严格说,'' | ||
| + | |||
| + | 所以它和前面那些三位数不是一类东西: | ||
| + | |||
| + | * **有响应 → 状态码才有意义**(200、404、500……),那是对方给你的结论; | ||
| + | * **没有响应 → 000**,说明「一次完整的 HTTP 交换没走完」,答案得从更下面一层去找。 | ||
| + | |||
| + | 常见的冒出 000 的地方: | ||
| + | |||
| + | ^ 出处 ^ 表现 ^ 该往哪查 ^ | ||
| + | | '' | ||
| + | | 前端 '' | ||
| + | | Nginx / 网关日志 | '' | ||
| + | | 监控拨测(Pingdom 之类) | 曲线里一根 000 | 探针根本连不上目标 | | ||
| + | | 压测 ab / wrk | 失败计数里带 000 | 连接被拒绝或被重置 | | ||
| + | |||
| + | '' | ||
| + | |||
| + | <code text> | ||
| + | 6 | ||
| + | 7 | ||
| + | 28 超时(连接超时或读取超时) | ||
| + | 35 TLS 握手失败 | ||
| + | 52 服务器空回复(连上了,但一个字没回) | ||
| + | 56 读取响应数据失败(连接被重置) | ||
| + | 60 证书校验失败 | ||
| + | </ | ||
| + | |||
| + | 排查顺序可以固定下来:**DNS → TCP 能否建连 → TLS 握手 → 是否收到响应首行 → 读取是否超时**。一层层往下走,别一上来就喊「服务器 500 了」——5xx 是拿到响应之后才可能有的结论。 | ||
| + | |||
| + | 还要和几个近邻分清: | ||
| + | |||
| + | * **499(Nginx 私有码)**:客户端在服务端回复前主动断开。这是 Nginx 自己观察到的,会写进日志;而 000 是调用方「什么都没收到」。 | ||
| + | * **504 Gateway Timeout**:网关等上游等超时,但它至少拿到了本层产生的响应,是正经状态码。 | ||
| + | * **浏览器里的 '' | ||
| + | |||
| + | 一句话:**看到 000,先别翻业务代码,去看网络链路和超时设置。** | ||
| + | |||
| + | ===== 三、404:最出名的那个 ===== | ||
| + | |||
| + | **404 Not Found 表示服务器找不到请求的目标资源**(URL 对应的文件、路由、记录都不存在),而且这个「找不到」是当前状态下的持久结论。 | ||
| + | |||
| + | 它的近亲很容易混,用一张表钉死: | ||
| + | |||
| + | ^ 状态码 ^ 含义 ^ 关键区别 ^ | ||
| + | | 400 Bad Request | 请求本身格式就不对(JSON 坏了、参数类型错) | 连解析都失败,与「资源在不在」无关 | | ||
| + | | 401 Unauthorized | 没认证 / 凭证无效 | 认证层的问题,响应**应当**带 '' | ||
| + | | 403 Forbidden | 认证过了,但不给看 | **资源明明存在**,只是你没权限 —— 用 404 掩护存在性是刻意的安全策略 | | ||
| + | | 404 Not Found | 资源不存在 | 最常见、也最容易被滥用 | | ||
| + | | 405 Method Not Allowed | 路径在,但方法不对 | 比如接口只开 POST,你发了 GET;响应**必须**带 '' | ||
| + | | 410 Gone | 曾经存在,已被永久删除 | 比 404 更明确,适合做下线公告;搜索引擎会据此摘除索引 | | ||
| + | | 451 Unavailable For Legal Reasons | 因法律原因不可访问 | 内容存在但被合规屏蔽 | | ||
| + | |||
| + | 那 404 该什么时候发: | ||
| + | |||
| + | * 路由完全没匹配上(''/ | ||
| + | * 静态资源没了(图片、JS 被删)。 | ||
| + | * **故意用来隐藏资源存在性**:对无权访问的私密资源返回 404 而不是 403,避免攻击者通过状态码差异枚举出「哪些 id 真实存在」。 | ||
| + | |||
| + | 注意两个坑: | ||
| + | |||
| + | * **软 404(soft 404)**:页面返回 '' | ||
| + | * **别把 404 当万能错误用**:接口里「参数校验失败」应该给 400 / 422,「没权限」给 403,全塞 404 会让调用方无法定位问题。 | ||
| + | |||
| + | ===== 四、303:重定向家族里最容易被忽略的一个 ===== | ||
| + | |||
| + | **303 See Other 的语义是:请求处理完了,你要的结果在 '' | ||
| + | |||
| + | 它存在的意义,最典型的场景就是 **PRG 模式(Post/ | ||
| + | |||
| + | <code text> | ||
| + | 用户提交表单 ──POST / | ||
| + | │ 创建成功,返回 | ||
| + | │ 303 Location: / | ||
| + | ▼ | ||
| + | 浏览器 ──GET / | ||
| + | </ | ||
| + | |||
| + | 如果没有这一步,用户刷新页面时浏览器就会**重复提交一次 POST**(经典的「重复下单 / 重复付款」来源)。返回 303 之后,刷新变成重新 GET 结果页,安全得多。 | ||
| + | |||
| + | 重定向家族五个兄弟的差别,全在**方法怎么变**和**是不是永久**这两点上: | ||
| + | |||
| + | ^ 状态码 ^ 名称 ^ 语义 ^ 方法是否保持 ^ 缓存 ^ | ||
| + | | 301 | Moved Permanently | 永久搬家 | 规范上不改变,旧实现常改成 GET | 可被长期缓存 | | ||
| + | | 302 | Found | 临时搬家 | 规范上不改变,旧实现常改成 GET | 不缓存 | | ||
| + | | **303** | **See Other** | 处理完了,去别处看结果 | **一律改成 GET** | 不缓存 | | ||
| + | | 307 | Temporary Redirect | 临时搬家 | **保持原方法** | 不缓存 | | ||
| + | | 308 | Permanent Redirect | 永久搬家 | **保持原方法** | 可被长期缓存 | | ||
| + | |||
| + | 记忆方式: | ||
| + | |||
| + | * 要**改变方法**用 303(POST 之后去看结果页); | ||
| + | * 要**保持方法**用 307 / 308(比如把 API 域名整体迁走,POST 还得是 POST); | ||
| + | * 301 / 302 在历史实现里行为不一致,涉及非 GET 请求的重定向时,优先用 307 / 308 明确表达意图。 | ||
| + | |||
| + | 顺手提一个近邻 **304 Not Modified**:它属于 3xx 但不是「重定向」,而是缓存协商 —— 浏览器带 '' | ||
| + | |||
| + | ===== 五、代码里怎么写 ===== | ||
| + | |||
| + | 服务端(Express 风格): | ||
| + | |||
| + | <code javascript> | ||
| + | // 404:放在所有路由之后兜底 | ||
| + | app.use((req, | ||
| + | res.status(404).json({ error: " | ||
| + | }); | ||
| + | |||
| + | // 303:POST 处理完之后,让浏览器改用 GET 去结果页 | ||
| + | app.post("/ | ||
| + | res.redirect(303, | ||
| + | }); | ||
| + | |||
| + | // 涉及非 GET 请求、又想保持方法,就用 307 / 308 | ||
| + | res.redirect(307, | ||
| + | </ | ||
| + | |||
| + | Nginx: | ||
| + | |||
| + | <code nginx> | ||
| + | # 自定义 404 页面 | ||
| + | error_page 404 / | ||
| + | |||
| + | # 把旧地址永久搬到新地址 | ||
| + | location = /old-path { return 301 /new-path; } | ||
| + | </ | ||
| + | |||
| + | 前端:**'' | ||
| + | |||
| + | <code javascript> | ||
| + | const res = await fetch("/ | ||
| + | method: " | ||
| + | redirect: " | ||
| + | body: JSON.stringify({ productId: 42 }), | ||
| + | }); | ||
| + | if (res.status === 303) { | ||
| + | console.log(" | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===== 六、常见坑 ===== | ||
| + | |||
| + | ^ 坑 ^ 说明 ^ | ||
| + | | 什么都返回 200 | 用响应体里的 '' | ||
| + | | 软 404 | HTTP 是 200、内容是「找不到」,搜索引擎会收录一堆废页 | | ||
| + | | 403 / 404 用反 | 公开接口该用 403 就用 403;要隐藏存在性时才刻意返回 404 | | ||
| + | | 400 与 422 混用 | 语法错(解析不了)用 400,语义校验失败(格式对但不合法)用 422 | | ||
| + | | 301 用成 302 | 永久迁移写成 302,权重和缓存都攒不住 | | ||
| + | | 重定向链太长 | A→B→C→D 层层跳,多一轮往返还容易被客户端直接判错 | | ||
| + | | POST 之后用 302 | 不同客户端可能改成 GET,行为不一致;要明确表达就用 303 或 307 | | ||
| + | | 重定向到 HTTP | HTTPS 站点跳回明文,等于白配 TLS | | ||
| + | | 5xx 当 4xx 处理 | 客户端把服务端故障当「参数错」直接报给用户,误导排查方向 | | ||
| + | | 把 000 当成 5xx | 000 表示压根没收到响应,问题在链路或超时,不在服务端业务逻辑 | | ||
| + | |||
| + | ===== 七、一句话总结 ===== | ||
| + | |||
| + | > **三位数的第一位定大类:4xx 是「你的请求有问题」,5xx 是「我的服务有问题」;404 表示资源不存在(别用 200 假装),303 表示「结果在别处,请用 GET 去拿」,是表单提交后防止重复提交的标准做法。** | ||
| + | |||
| + | 参考: | ||
| + | |||
| + | * RFC 9110 —— [[https:// | ||
| + | * RFC 9110 §15.5.4 —— [[https:// | ||
| + | * RFC 9110 §15.4.4 —— [[https:// | ||
| + | * MDN —— [[https:// | ||
| + | |||
| + | 相关:[[代码术语: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[代码术语]] | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # HTTP 状态码 | ||
| + | |||
| + | ## 三位数怎么读 | ||
| + | - 首位定大类,后两位是具体原因 | ||
| + | - 1xx 信息性:100 / 101 / 103 | ||
| + | - 2xx 成功:200 / 201 / 204 / 206 | ||
| + | - 3xx 重定向:301 / 302 / 303 / 304 / 307 / 308 | ||
| + | - 4xx 客户端错误:400 / 401 / 403 / 404 / 405 / 422 / 429 | ||
| + | - 5xx 服务端错误:500 / 502 / 503 / 504 | ||
| + | |||
| + | ## 谁的责任 | ||
| + | - 4xx:改请求才有意义 | ||
| + | - 5xx:服务端故障,重试往往有用 | ||
| + | - 状态码是给程序看的 | ||
| + | - 别用 200 包 code 字段 | ||
| + | |||
| + | ## 000 不是状态码 | ||
| + | - 工具里的占位,RFC 没定义 | ||
| + | - 含义:没读到响应首行 | ||
| + | - 有响应才谈得上 5xx | ||
| + | - curl -w 打印 000,退出码非 0 | ||
| + | - fetch 里是 status 0(CORS / 断连) | ||
| + | - 网关日志、拨测、压测也会出现 | ||
| + | - 与 499:客户端提前断开 | ||
| + | - 与 504:网关超时,但有正经响应 | ||
| + | - curl 退出码 6 / 7 / 28 / 35 / 56 / 60 | ||
| + | - 排查:DNS → TCP → TLS → 响应 → 超时 | ||
| + | |||
| + | ## 404 是什么 | ||
| + | - 资源不存在 | ||
| + | - 路由、静态文件、记录都没了 | ||
| + | - 与 403:资源存在但不给看 | ||
| + | - 与 405:路径在,方法错 | ||
| + | - 与 410:曾存在,已永久删除 | ||
| + | - 与 451:存在但被合规屏蔽 | ||
| + | - 可刻意返回 404 隐藏资源存在性 | ||
| + | |||
| + | ## 软 404 与滥用 | ||
| + | - HTTP 200,正文写" | ||
| + | - 爬虫被骗,收录大量废页 | ||
| + | - 参数错给 400 / 422 | ||
| + | - 无权限给 403 | ||
| + | - 全塞 404 会让调用方无法定位 | ||
| + | |||
| + | ## 303 是什么 | ||
| + | - See Other | ||
| + | - 结果在 Location 指向的 URL | ||
| + | - 强制把方法改成 GET | ||
| + | - PRG 模式:Post / Redirect / Get | ||
| + | - 刷新不再重发 POST | ||
| + | - 防重复下单、重复付款 | ||
| + | |||
| + | ## 重定向五兄弟 | ||
| + | - 301 永久,可长期缓存 | ||
| + | - 302 临时,不缓存 | ||
| + | - 303 去别处看,一律改 GET | ||
| + | - 307 临时,保持原方法 | ||
| + | - 308 永久,保持原方法 | ||
| + | - 304 是缓存协商,不是跳转 | ||
| + | |||
| + | ## 代码落地 | ||
| + | - Express:res.status(404) 兜底中间件放最后 | ||
| + | - res.redirect(303, | ||
| + | - 保持方法用 res.redirect(307, | ||
| + | - Nginx:error_page 404 /404.html | ||
| + | - Nginx:return 301 /new-path | ||
| + | - fetch 默认 follow,观察用 redirect: " | ||
| + | - 303 时会读 Location 头 | ||
| + | |||
| + | ## 常见坑 | ||
| + | - 什么都返回 200 | ||
| + | - 软 404 | ||
| + | - 403 与 404 用反 | ||
| + | - 400 与 422 混用 | ||
| + | - 301 写成 302 | ||
| + | - 重定向链太长 | ||
| + | - POST 之后用 302 | ||
| + | - 重定向到 HTTP | ||
| + | - 5xx 当 4xx 处理 | ||
| + | - 把 000 当成 5xx | ||
| + | ``` | ||