JavaScript fetch 怎样区分网络失败和 HTTP 404
来源:17golang原创
时间:2026-11-19 19:57:53 239浏览 收藏
JavaScript fetch 收到可供脚本读取的 HTTP 404 时,通常仍会兑现 Promise 并交给你一个 Response;要通过 response.status 或 response.ok 判断 HTTP 结果。网络等请求失败可能使 Promise 拒绝,但 catch 也可能收到你自己抛出的异常或正文读取异常,不能只凭进入 catch 就断言“断网”。
Fetch 标准地址:https://fetch.spec.whatwg.org/
下面把已有的错误处理写法改成三个明确边界。这是对现有 API 语义的解释与代码改造建议,不是新提案或新版本发布。示例为本次原创,未在本机执行;路径 /api/catalog/missing 是需要替换为项目接口的示例地址。
为什么只写 catch 会漏掉 404
假设页面请求一个已删除的商品目录。如果后端返回 404,页面应该提示资源不存在;如果请求本身失败,页面才应提示暂时无法取得响应。把这两类情况交给同一条“网络异常”文案,会让排查从一开始就找错方向。
async function oldLoad(url) {
try {
// 问题在于未检查 HTTP 状态,直接假设正文是 JSON
const response = await fetch(url);
return await response.json();
} catch (error) {
// 这里也可能是 JSON 解析失败,不能认定都是网络故障
console.error("无法加载目录", error);
return null;
}
}
旧写法的缺口不是缺少 catch,而是没有给 HTTP 响应单独的判断位置。若 404 正文恰好是合法 JSON,它还可能被当成正常数据返回。若它是 HTML 错误页,解析报错又会遮住本来更有用的 404。
用三个边界解释 fetch 的错误语义
先区分三个位置:fetch 的 Promise、Response 的状态字段、response.json() 的正文读取。前者解决“是否取得响应对象”,状态字段解决“HTTP 是否成功”,正文读取解决“拿到的数据是否可按约定解析”。对脚本可见的普通响应,ok 在状态码为 200–299 时为 true;404 的 ok 为 false。

| 现象 | 判断位置 | 页面处理方向 |
|---|---|---|
| 请求阶段拒绝 | await fetch 的局部 catch | 记录原始异常,提示未取得可用响应 |
| HTTP 404 | response.status | 提示目录不存在 |
| 其他非成功 HTTP 状态 | response.ok 为 false | 保留状态码,按接口约定处理 |
| 成功状态但正文读取失败 | response.json 的局部 catch | 提示响应内容无法处理 |
以上基础行为可参阅 MDN Fetch 使用文档。请求阶段的拒绝还可能与取消、请求配置或浏览器策略有关;不要用异常文字做跨浏览器的精确故障分类。
把旧写法改成可分类的请求函数
下面的函数采用显式返回值契约:kind 为 request、http、body、unreadable 或 ok。每个 catch 只覆盖自己的操作,因此无需从一个大 catch 里猜异常来自哪里。这里的分类名称属于示例应用,不是浏览器标准中的错误类型。
async function loadCatalog(url, { signal } = {}) {
let response;
try {
// 这里只捕获请求阶段的拒绝,不在这里解析 JSON
response = await fetch(url, { signal });
} catch (cause) {
return { kind: "request", aborted: signal?.aborted === true, cause };
}
// 不透明响应的状态不可见,不能把 0 当成服务端 HTTP 状态
if (response.type === "opaque" || response.type === "opaqueredirect") {
return { kind: "unreadable", type: response.type };
}
if (!response.ok) {
return { kind: "http", status: response.status };
}
if (response.status === 204) {
// 这个业务约定把无内容响应作为空结果
return { kind: "ok", status: 204, data: null };
}
try {
const data = await response.json();
return { kind: "ok", status: response.status, data };
} catch (cause) {
// HTTP 成功不代表正文一定能读取或解析
return { kind: "body", status: response.status, cause };
}
}
收到可见的 404 时,函数直接返回 kind: "http" 与 status: 404,不会先解析错误页。请求被拒绝时返回 request;如果调用方提供的 signal 已取消,aborted 会反映这一信号状态。这个布尔值不承诺识别所有超时与取消策略,也不把其他 request 错误自动归类为物理网络中断。
对于 body 类别,status 仍然保留,便于区分“HTTP 200 的正文出错”和“HTTP 404”。正文失败可能发生在读取或 JSON 解析过程中,不应一律写成“JSON 格式错误”。
兼容不透明响应与空正文
上面的函数针对浏览器 Fetch。不要用 mode: "no-cors" 来解决读取跨域 JSON 的需求;当浏览器交付 opaque 响应时,脚本看不到真实状态,其 status 是 0。示例把 opaque 和 opaqueredirect 单独列为 unreadable,避免把这个受限视图包装成 HTTP 0 错误。状态可见性与成功状态的定义见 WHATWG Fetch 标准。
接口如果允许 204,无内容时就不应强行解析 JSON。示例明确约定 204 对应 data: null;如果你的业务不能接受空数据,应在调用方把 null 视为业务状态,而不是声称发生了网络故障。对其他空正文状态是否接受,也应由接口契约决定。

在页面中采用明确的错误分类
async function showCatalog() {
// 使用项目自己的同源接口替换此示例路径
const result = await loadCatalog("/api/catalog/missing");
if (result.kind === "http") {
console.info(result.status === 404 ? "目录不存在" : "服务返回非成功状态", result.status);
} else if (result.kind === "request") {
console.info(result.aborted ? "请求已取消" : "暂时无法取得响应");
} else if (result.kind === "body") {
console.info("响应内容无法处理", result.status);
} else if (result.kind === "unreadable") {
console.info("当前响应不向脚本公开状态");
} else {
// 由页面根据实际数据渲染列表或空状态
console.info("可交给页面的数据", result.data);
}
}
迁移时可以先替换请求函数,再逐个调整调用方对 kind 的处理。示例只用 console 表示页面分支,不假定项目使用任何框架。若原调用方依赖“所有失败都抛异常”,需要一起修改调用约定,不能直接把结构化结果当成原来的业务数据。
采用这套分类也不意味着所有失败都应该重试。对于 404,先检查资源标识与路由;对于 request,保留异常用于排查请求配置、网络和浏览器策略;对于 body,核对接口正文约定。不要让分类函数本身重复发送请求。
常见问题
为什么 404 有时也会进入 catch?
检查是否显式 throw、是否调用了会抛错的包装器,或者是否在同一个 try 中解析了 HTML 错误页。fetch 收到 404 与后续代码抛错是不同位置。
response.ok 为 true 就代表业务成功吗?
它只表达成功 HTTP 状态。业务字段是否有效、目录是否为空,需要页面依据接口契约另行判断。
能根据 TypeError 确认断网吗?
不能。即使异常出现在 await fetch 附近,也应结合请求上下文调查;仅凭异常类型不足以认定某一个网络根因。
-
278 收藏
-
130 收藏
-
483 收藏
-
291 收藏
-
195 收藏
-
文章 · 前端 | 9分钟前 | 前端 · javascript · JavaScript iframe document importNode createHTMLDocument DOMImplementation329 收藏
-
239 收藏
-
357 收藏
-
261 收藏
-
423 收藏
-
文章 · 前端 | 35分钟前 | 前端 · javascript · 性能排查 · JavaScript requestAnimationFrame ResizeObserver 前端布局 ResizeObserver loop478 收藏
-
283 收藏
-
326 收藏
-
391 收藏
-
492 收藏
-
文章 · 前端 | 1天前 | 前端 · javascript · JavaScript CSSOM CSSStyleSheet CSSRule parentStyleSheet cssRules parentRule323 收藏
-
105 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习