当前位置:首页 > 文章列表 > 文章 > 前端 > JavaScript fetch 怎样区分网络失败和 HTTP 404

JavaScript fetch 怎样区分网络失败和 HTTP 404

来源:17golang原创 2026-11-19 19:57:53 0浏览 收藏

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。

fetch、Response 与正文读取的静态关系
图1:静态说明图。请求分组包含 fetch 和 Promise 拒绝,响应分组包含 Response、status 与 ok,正文分组包含 json()。分组解释职责,连线不代表执行步骤。
现象判断位置页面处理方向
请求阶段拒绝await fetch 的局部 catch记录原始异常,提示未取得可用响应
HTTP 404response.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 视为业务状态,而不是声称发生了网络故障。对其他空正文状态是否接受,也应由接口契约决定。

请求函数结果类别与状态字段的静态结构
图2:结构说明图。结果契约分组连接请求、HTTP、正文和成功类别;状态信息分组解释 status 在哪些结果中保留。不透明响应另行处理,不能从 status 0 推断真实 HTTP 状态。

在页面中采用明确的错误分类

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 附近,也应结合请求上下文调查;仅凭异常类型不足以认定某一个网络根因。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
JavaScript ResizeObserver 怎样避免观察回调循环JavaScript ResizeObserver 怎样避免观察回调循环
上一篇
JavaScript ResizeObserver 怎样避免观察回调循环
JavaScript AbortController.abort(reason) 怎样把取消原因传给调用方
下一篇
JavaScript AbortController.abort(reason) 怎样把取消原因传给调用方
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1128次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1112次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1287次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1227次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1078次使用