显示页面讨论过去修订反向链接回到顶部 本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。 ====== 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 ``` 登录 Detach Close 该主题尚不存在 您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。 代码术语/404_303_这些是什么.txt 最后更改: 2026/10/16 12:02由 张叶安 登录