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

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

参考:

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

该主题尚不存在

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

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