代码术语:404_303_这些是什么

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
代码术语:404_303_这些是什么 [2026/10/14 16:46] – 创建 张叶安代码术语:404_303_这些是什么 [2026/10/16 12:02] (当前版本) – 思维导图新增「000 不是状态码」分支 张叶安
行 1: 行 1:
-1+====== 404、303 这些是什么 ====== 
 + 
 +第一次看到 ''404''、''303'' 这类三位数字,很容易以为是某种错误代号。其实它们是 **HTTP 状态码(HTTP status code)** —— 服务器在每一个响应里附带的「这次请求处理得怎么样」的一行结论。数字第一位就是大类,后两位是这个大类里的具体原因。 
 + 
 +<code http> 
 +HTTP/1.1 404 Not Found 
 +Content-Type: text/html 
 +</code> 
 + 
 +下面按「先看懂数字本身,再挑出 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 包着一个 ''{ "code": 404 }'' 去「兼容」——那等于把机器可读的信息抹掉了。 
 + 
 +===== 二、000:不是状态码,而是「没拿到状态码」 ===== 
 + 
 +严格说,''000'' **不是一个 HTTP 状态码**,RFC 里没有定义它,也没有哪个服务器会主动发出它。它只出现在**工具的输出**里,含义只有一个:**这次请求根本没读到响应的第一行**——连接没建立,或者建立了却断在半路。既然没有状态行可解析,工具里那个固定按三位数字渲染的字段就补一个 ''000'' 当占位符。 
 + 
 +所以它和前面那些三位数不是一类东西: 
 + 
 +  * **有响应 → 状态码才有意义**(200、404、500……),那是对方给你的结论; 
 +  * **没有响应 → 000**,说明「一次完整的 HTTP 交换没走完」,答案得从更下面一层去找。 
 + 
 +常见的冒出 000 的地方: 
 + 
 +^ 出处 ^ 表现 ^ 该往哪查 ^ 
 +| ''curl -w "%{http_code}"'' | 打印 ''000'',退出码非 0 | DNS、建连、TLS、超时,先看退出码 | 
 +| 前端 ''fetch'' / XHR | ''response.status === 0'' | CORS 被拦、连接被断、页面已卸载 | 
 +| Nginx / 网关日志 | ''$status'' 记成 000 或 ''-'' | 还没产生响应就断连,例如客户端提前挂断 | 
 +| 监控拨测(Pingdom 之类) | 曲线里一根 000 | 探针根本连不上目标 | 
 +| 压测 ab / wrk | 失败计数里带 000 | 连接被拒绝或被重置 | 
 + 
 +''curl'' 的**退出码比 000 有用得多**:000 只告诉你「没拿到」,退出码才告诉你是谁的问题: 
 + 
 +<code text> 
 +6   无法解析主机名(DNS) 
 +7   连接被拒绝 / 无法建连 
 +28  超时(连接超时或读取超时) 
 +35  TLS 握手失败 
 +52  服务器空回复(连上了,但一个字没回) 
 +56  读取响应数据失败(连接被重置) 
 +60  证书校验失败 
 +</code> 
 + 
 +排查顺序可以固定下来:**DNS → TCP 能否建连 → TLS 握手 → 是否收到响应首行 → 读取是否超时**。一层层往下走,别一上来就喊「服务器 500 了」——5xx 是拿到响应之后才可能有的结论。 
 + 
 +还要和几个近邻分清: 
 + 
 +  * **499(Nginx 私有码)**:客户端在服务端回复前主动断开。这是 Nginx 自己观察到的,会写进日志;而 000 是调用方「什么都没收到」。 
 +  * **504 Gateway Timeout**:网关等上游等超时,但它至少拿到了本层产生的响应,是正经状态码。 
 +  * **浏览器里的 ''0'' 和日志里的 ''000''**:同一件事,''fetch'' 的 ''status'' 是数字所以写作 0,日志字段按三位补齐就成了 000。 
 + 
 +一句话:**看到 000,先别翻业务代码,去看网络链路和超时设置。** 
 + 
 +===== 三、404:最出名的那个 ===== 
 + 
 +**404 Not Found 表示服务器找不到请求的目标资源**(URL 对应的文件、路由、记录都不存在),而且这个「找不到」是当前状态下的持久结论。 
 + 
 +它的近亲很容易混,用一张表钉死: 
 + 
 +^ 状态码 ^ 含义 ^ 关键区别 ^ 
 +| 400 Bad Request | 请求本身格式就不对(JSON 坏了、参数类型错) | 连解析都失败,与「资源在不在」无关 | 
 +| 401 Unauthorized | 没认证 / 凭证无效 | 认证层的问题,响应**应当**带 ''WWW-Authenticate'' | 
 +| 403 Forbidden | 认证过了,但不给看 | **资源明明存在**,只是你没权限 —— 用 404 掩护存在性是刻意的安全策略 | 
 +| 404 Not Found | 资源不存在 | 最常见、也最容易被滥用 | 
 +| 405 Method Not Allowed | 路径在,但方法不对 | 比如接口只开 POST,你发了 GET;响应**必须**带 ''Allow'' 头 | 
 +| 410 Gone | 曾经存在,已被永久删除 | 比 404 更明确,适合做下线公告;搜索引擎会据此摘除索引 | 
 +| 451 Unavailable For Legal Reasons | 因法律原因不可访问 | 内容存在但被合规屏蔽 | 
 + 
 +那 404 该什么时候发: 
 + 
 +  * 路由完全没匹配上(''/api/users/999'' 里这个 id 不存在)。 
 +  * 静态资源没了(图片、JS 被删)。 
 +  * **故意用来隐藏资源存在性**:对无权访问的私密资源返回 404 而不是 403,避免攻击者通过状态码差异枚举出「哪些 id 真实存在」。 
 + 
 +注意两个坑: 
 + 
 +  * **软 404(soft 404)**:页面返回 ''200 OK'',正文却写着「页面不存在」。人看着没问题,爬虫却被骗了,会造成大量无效 URL 被收录。 
 +  * **别把 404 当万能错误用**:接口里「参数校验失败」应该给 400 / 422,「没权限」给 403,全塞 404 会让调用方无法定位问题。 
 + 
 +===== 四、303:重定向家族里最容易被忽略的一个 ===== 
 + 
 +**303 See Other 的语义是:请求处理完了,你要的结果在 ''Location'' 指示的另一个 URL 上,而且请用 GET 去拿。** 后半句才是它的价值 —— 它**强制把方法改成 GET**(除非原请求就是 HEAD)。 
 + 
 +它存在的意义,最典型的场景就是 **PRG 模式(Post/Redirect/Get)**: 
 + 
 +<code text> 
 +用户提交表单 ──POST /orders──▶ 服务器 
 +                                │ 创建成功,返回 
 +                                │ 303 Location: /orders/123 
 +                                ▼ 
 +浏览器 ──GET /orders/123──▶ 服务器   ← 展示结果页 
 +</code> 
 + 
 +如果没有这一步,用户刷新页面时浏览器就会**重复提交一次 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 但不是「重定向」,而是缓存协商 —— 浏览器带 ''If-None-Match'' / ''If-Modified-Since'' 来问「我本地那份还能用吗」,服务器答 304 表示「没变,直接用本地缓存」,不传正文,省流量。 
 + 
 +===== 五、代码里怎么写 ===== 
 + 
 +服务端(Express 风格): 
 + 
 +<code javascript> 
 +// 404:放在所有路由之后兜底 
 +app.use((req, res) => { 
 +  res.status(404).json({ error: "not_found", path: req.path }); 
 +}); 
 + 
 +// 303:POST 处理完之后,让浏览器改用 GET 去结果页 
 +app.post("/orders", createOrder, (req, res) => { 
 +  res.redirect(303, `/orders/${req.order.id}`);   // 显式写 303 
 +}); 
 + 
 +// 涉及非 GET 请求、又想保持方法,就用 307 / 308 
 +res.redirect(307, "/new-endpoint"); 
 +</code> 
 + 
 +Nginx: 
 + 
 +<code nginx> 
 +# 自定义 404 页面 
 +error_page 404 /404.html; 
 + 
 +# 把旧地址永久搬到新地址 
 +location = /old-path { return 301 /new-path; } 
 +</code> 
 + 
 +前端:**''fetch'' 默认会自动跟随重定向**,浏览器对 303 的处理就是「把 POST 换成 GET 再去 ''Location''」,所以你通常什么都不用做;要观察原始响应就得关掉跟随: 
 + 
 +<code javascript> 
 +const res = await fetch("/api/orders", { 
 +  method: "POST", 
 +  redirect: "manual",   // 默认是 "follow",自动跟随 
 +  body: JSON.stringify({ productId: 42 }), 
 +}); 
 +if (res.status === 303) { 
 +  console.log("去这里看结果:", res.headers.get("location")); 
 +} 
 +</code> 
 + 
 +===== 六、常见坑 ===== 
 + 
 +^ 坑 ^ 说明 ^ 
 +| 什么都返回 200 | 用响应体里的 ''code'' 代替状态码,网关、缓存、监控全部失效 | 
 +| 软 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://www.rfc-editor.org/rfc/rfc9110.html|HTTP Semantics(状态码总定义)]] 
 +  * RFC 9110 §15.5.4 —— [[https://www.rfc-editor.org/rfc/rfc9110.html#name-404-not-found|404 Not Found]] 
 +  * RFC 9110 §15.4.4 —— [[https://www.rfc-editor.org/rfc/rfc9110.html#name-303-see-other|303 See Other]] 
 +  * MDN —— [[https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Status|HTTP 响应状态码]] 
 + 
 +相关:[[代码术语:authorization|Authorization(401 与 403)]] · [[代码术语:bearer|Bearer]] · [[代码术语:cookie|Cookie]] 
 + 
 +---- 
 + 
 +返回:[[代码术语]] 
 + 
 +```mdk height=560 color=#4f46e5 
 +# 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, url) 
 +- 保持方法用 res.redirect(307, url) 
 +- Nginx:error_page 404 /404.html 
 +- Nginx:return 301 /new-path 
 +- fetch 默认 follow,观察用 redirect: "manual" 
 +- 303 时会读 Location 头 
 + 
 +## 常见坑 
 +- 什么都返回 200 
 +- 软 404 
 +- 403 与 404 用反 
 +- 400 与 422 混用 
 +- 301 写成 302 
 +- 重定向链太长 
 +- POST 之后用 302 
 +- 重定向到 HTTP 
 +- 5xx 当 4xx 处理 
 +- 把 000 当成 5xx 
 +``` 

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/404_303_这些是什么.1791967602.txt.gz
  • 最后更改: 2026/10/14 16:46
  • 由 张叶安