如何在javascript中发起网络请求_从Fetch API到Axios的最佳实践【教程】

秋丽大大_7573

秋丽大大_7573

2026-01-16

870人浏览

原创

应根据项目需求选择 Fetch 或 Axios:Fetch 轻量现代但需手动处理错误、超时和取消;Axios 提供拦截器、自动 JSON 解析等便利功能,但增加依赖。关键在统一错误分类与状态管理。

如何在javascript中发起网络请求_从fetch api到axios的最佳实践【教程】

Fetch API 是现代浏览器发起网络请求的原生方案,但直接使用它容易忽略错误处理、超时控制和请求取消等关键问题;Axios 提供了更友好的默认行为和可扩展能力,但引入额外依赖需权衡。是否用 Axios,取决于你是否需要拦截器、自动 JSON 解析、取消请求或 IE 兼容性支持。

Fetch API 的常见陷阱与修复写法

原生 fetch() 不会因 HTTP 状态码(如 404、500)抛出错误,response.ok 必须手动检查;同时它不支持超时,且无法中止正在进行的请求(除非用 AbortController)。

  • 忘记检查 response.ok → 导致 4xx/5xx 响应被当作成功处理
  • 没传 signal → 请求卡死时无法主动中断
  • 未设置 Content-Type 或 credentials → 登录态丢失或后端拒收
const controller = new AbortController();
setTimeout(() => controller.abort(), 8000);

try {
  const res = await fetch('/api/data', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ id: 123 }),
    signal: controller.signal,
    credentials: 'include'
  });

  if (!res.ok) throw new Error(`HTTP ${res.status}`);

  const data = await res.json();
} catch (err) {
  if (err.name === 'AbortError') console.log('请求已超时或取消');
  else console.error('请求失败:', err);
}

Axios 的配置要点与默认行为差异

Axios 默认自动解析 JSON 响应体,但默认不携带 cookies(withCredentials: false),且响应结构是包裹式的 response.data,不是裸数据。它的拦截器非常实用,但要注意:请求拦截器中修改 config.url 后,baseURL 不再生效。

  • axios.defaults.baseURL 只影响未以 http:// 开头的 URL
  • 响应拦截器里抛错,会进入 .catch(),但原始 response 已不可见 —— 需提前保存
  • 取消请求必须用 CancelToken.source() 或 AbortController(v0.27+)
axios.defaults.withCredentials = true;

axios.interceptors.request.use(config => {
  config.headers.Authorization = `Bearer ${getToken()}`;
  return config;
});

axios.interceptors.response.use(
  res => res.data, // 统一提取 data
  err => {
    if (err.response?.status === 401) logout();
    return Promise.reject(err);
  }
);

何时该坚持用 Fetch,而非引入 Axios

项目已用 ESM 按需加载、目标环境为现代浏览器(Chrome 62+/Firefox 57+)、团队倾向最小依赖、且不需要请求重试或复杂拦截逻辑时,Fetch 更轻量可控。尤其在 Service Worker 或 Deno 环境中,Axios 并不适用。

前端设计引擎
前端设计引擎

使用此技能可创建独具特色、具备生产级质量的前端界面,设计品质高。当用户要求构建网页组件、页面、产物、海报或应用程序时(例如:网站、落地页、仪表盘、React 组件、HTML/CSS 布局,或对任意 Web UI 进行样式优化与视觉美化),请启用该能力。输出需为富有创意、精雕细琢的代码与 UI 设计,避免千篇一律的 AI 风格。

下载
  • 构建产物大小敏感(Axios gzip 后约 4.5KB,Fetch 零成本)
  • 需要精细控制流:比如用 ReadableStream 处理大文件分块上传
  • 已有封装层(如 SWR、React Query)接管请求逻辑,Axios 的拦截器反而冗余

并发请求与错误聚合的实际处理方式

无论是 Promise.all() 还是 axios.all(),任一请求失败都会导致整个集合 reject。真实场景中往往需要“尽力而为”——即返回所有结果(含错误),而不是中断全部。

  • 用 Promise.allSettled() 替代 Promise.all(),获取每个请求的 { status: 'fulfilled' | 'rejected', value | reason }
  • Axios 中避免在单个 axios.all() 调用里混用不同 base URL 或超时策略
  • 对批量 ID 查询,优先考虑服务端聚合接口,而非前端发 N 个请求
const requests = ids.map(id =>
  fetch(`/api/user/${id}`).then(r => r.json()).catch(err => ({ error: err.message }))
);

const results = await Promise.allSettled(requests);
const successes = results.filter(r => r.status === 'fulfilled').map(r => r.value);
const failures = results.filter(r => r.status === 'rejected').map(r => r.reason);

真正麻烦的不是选 Fetch 还是 Axios,而是统一错误分类(网络层?业务层?认证失效?)、标准化 loading 状态管理、以及让 timeout 和 abort 行为在 UI 上可感知 —— 这些几乎从不在库文档里写清楚,却直接影响调试效率。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2195

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3462

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1156

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3979

7

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2826

5

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.06

5639

7

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

2026.03.24

4007

22

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3188

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5089

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.3万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习