404、303 这些是什么
第一次看到 404、303 这类三位数字,很容易以为是某种错误代号。其实它们是 HTTP 状态码(HTTP status code) —— 服务器在每一个响应里附带的「这次请求处理得怎么样」的一行结论。数字第一位就是大类,后两位是这个大类里的具体原因。
HTTP/1.1 404 Not Found Content-Type: text/html
下面按「先看懂数字本身,再挑出 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 只告诉你「没拿到」,退出码才告诉你是谁的问题:
6 无法解析主机名(DNS) 7 连接被拒绝 / 无法建连 28 超时(连接超时或读取超时) 35 TLS 握手失败 52 服务器空回复(连上了,但一个字没回) 56 读取响应数据失败(连接被重置) 60 证书校验失败
排查顺序可以固定下来: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):
用户提交表单 ──POST /orders──▶ 服务器
│ 创建成功,返回
│ 303 Location: /orders/123
▼
浏览器 ──GET /orders/123──▶ 服务器 ← 展示结果页
如果没有这一步,用户刷新页面时浏览器就会重复提交一次 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 风格):
// 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");
Nginx:
# 自定义 404 页面 error_page 404 /404.html; # 把旧地址永久搬到新地址 location = /old-path { return 301 /new-path; }
前端:fetch 默认会自动跟随重定向,浏览器对 303 的处理就是「把 POST 换成 GET 再去 Location」,所以你通常什么都不用做;要观察原始响应就得关掉跟随:
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")); }
六、常见坑
| 坑 | 说明 |
|---|---|
| 什么都返回 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 —— HTTP Semantics(状态码总定义)
- RFC 9110 §15.5.4 —— 404 Not Found
- RFC 9110 §15.4.4 —— 303 See Other
- MDN —— HTTP 响应状态码
相关:Authorization(401 与 403) · Bearer · Cookie
返回:代码术语
# 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