差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| 代码术语:404_303_这些是什么 [2026/10/14 16:47] – 补全 HTTP 状态码词条:重点讲解 404 与 303 张叶安 | 代码术语:404_303_这些是什么 [2026/10/16 12:02] (当前版本) – 思维导图新增「000 不是状态码」分支 张叶安 | ||
|---|---|---|---|
| 行 24: | 行 24: | ||
| * **状态码是给程序看的,不是给人看的。** 前端、网关、缓存、爬虫都靠它做分支判断,所以别用 200 包着一个 '' | * **状态码是给程序看的,不是给人看的。** 前端、网关、缓存、爬虫都靠它做分支判断,所以别用 200 包着一个 '' | ||
| - | ===== 二、404:最出名的那个 ===== | + | ===== 二、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 对应的文件、路由、记录都不存在),而且这个「找不到」是当前状态下的持久结论。 | **404 Not Found 表示服务器找不到请求的目标资源**(URL 对应的文件、路由、记录都不存在),而且这个「找不到」是当前状态下的持久结论。 | ||
| 行 50: | 行 90: | ||
| * **别把 404 当万能错误用**:接口里「参数校验失败」应该给 400 / 422,「没权限」给 403,全塞 404 会让调用方无法定位问题。 | * **别把 404 当万能错误用**:接口里「参数校验失败」应该给 400 / 422,「没权限」给 403,全塞 404 会让调用方无法定位问题。 | ||
| - | ===== 三、303:重定向家族里最容易被忽略的一个 ===== | + | ===== 四、303:重定向家族里最容易被忽略的一个 ===== |
| **303 See Other 的语义是:请求处理完了,你要的结果在 '' | **303 See Other 的语义是:请求处理完了,你要的结果在 '' | ||
| 行 83: | 行 123: | ||
| 顺手提一个近邻 **304 Not Modified**:它属于 3xx 但不是「重定向」,而是缓存协商 —— 浏览器带 '' | 顺手提一个近邻 **304 Not Modified**:它属于 3xx 但不是「重定向」,而是缓存协商 —— 浏览器带 '' | ||
| - | ===== 四、代码里怎么写 ===== | + | ===== 五、代码里怎么写 ===== |
| 服务端(Express 风格): | 服务端(Express 风格): | ||
| 行 125: | 行 165: | ||
| </ | </ | ||
| - | ===== 五、常见坑 ===== | + | ===== 六、常见坑 ===== |
| ^ 坑 ^ 说明 ^ | ^ 坑 ^ 说明 ^ | ||
| 行 137: | 行 177: | ||
| | 重定向到 HTTP | HTTPS 站点跳回明文,等于白配 TLS | | | 重定向到 HTTP | HTTPS 站点跳回明文,等于白配 TLS | | ||
| | 5xx 当 4xx 处理 | 客户端把服务端故障当「参数错」直接报给用户,误导排查方向 | | | 5xx 当 4xx 处理 | 客户端把服务端故障当「参数错」直接报给用户,误导排查方向 | | ||
| + | | 把 000 当成 5xx | 000 表示压根没收到响应,问题在链路或超时,不在服务端业务逻辑 | | ||
| - | ===== 六、一句话总结 ===== | + | ===== 七、一句话总结 ===== |
| > **三位数的第一位定大类:4xx 是「你的请求有问题」,5xx 是「我的服务有问题」;404 表示资源不存在(别用 200 假装),303 表示「结果在别处,请用 GET 去拿」,是表单提交后防止重复提交的标准做法。** | > **三位数的第一位定大类:4xx 是「你的请求有问题」,5xx 是「我的服务有问题」;404 表示资源不存在(别用 200 假装),303 表示「结果在别处,请用 GET 去拿」,是表单提交后防止重复提交的标准做法。** | ||
| 行 154: | 行 195: | ||
| 返回:[[代码术语]] | 返回:[[代码术语]] | ||
| + | |||
| + | ```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 | ||
| + | ``` | ||