目录

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

两条实战口径:

二、000:不是状态码,而是「没拿到状态码」

严格说,000 不是一个 HTTP 状态码,RFC 里没有定义它,也没有哪个服务器会主动发出它。它只出现在工具的输出里,含义只有一个:这次请求根本没读到响应的第一行——连接没建立,或者建立了却断在半路。既然没有状态行可解析,工具里那个固定按三位数字渲染的字段就补一个 000 当占位符。

所以它和前面那些三位数不是一类东西:

常见的冒出 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 是拿到响应之后才可能有的结论。

还要和几个近邻分清:

一句话:看到 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 该什么时候发:

注意两个坑:

四、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 永久搬家 保持原方法 可被长期缓存

记忆方式:

顺手提一个近邻 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 去拿」,是表单提交后防止重复提交的标准做法。**

参考:

相关: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