深入对比JavaScript中三大网络请求方案:XMLHttpRequest、Fetch与Axios。剖析底层运行架构、HTTP状态码异常处理、拦截器流水线、上传进度支持及选型决策树,助你准确选择最适合项目的方案。
JS网络请求方案对比:Fetch、XMLHttpRequest与Axios怎么选
时间:2026-11-18
浏览:556
文章目录
XMLHttpRequest、现代浏览器原生标准的 Fetch API,以及广泛使用的第三方库 Axios。结论先行:如果是在现代浏览器环境下构建轻量页面、H5 或微前端子应用,对打包体积有严苛要求,原生 Fetch 是最干净的零依赖选择;如果是开发中大型企业后台、单页应用(SPA)或需要跨浏览器与 Node.js 服务端的同构项目,Axios 开箱即用的拦截器流水线、自动错误状态判定与统一异常机制能显著节省维护成本;而 XMLHttpRequest 目前主要用于维护遗留系统或直接调用其原生上传进度事件。本文将深入拆解三者的核心机制与差异,提供清晰的选型路径。
一、三种方案的核心机制与演进背景
要理解如何选择,首先需要看清它们在浏览器运行时中的位置与实现机制。它们并不是同代技术的竞争,而是 Web 技术从回调地狱向 Promise 标准演进不同阶段的产物。
1. XMLHttpRequest:经典的事件驱动基石
XMLHttpRequest(简称 XHR)早在 2000 年代初就伴随着 Ajax 理念问世。它的底层直接绑定浏览器 C++ 宿主对象,采用严格的事件驱动模型。开发者必须通过实例化对象、配置监听器、打开连接并在最后调用发送方法。这种基于 onreadystatechange 和数字状态码(0 到 4)的回调机制,不仅代码冗长,在嵌套多重依赖请求时还会迅速陷入回调地狱。
2. Fetch API:现代 Web 的底层原生标准
为了摆脱 XHR 复杂的事件模型,WHATWG 与 W3C 制定了现代原生的 Fetch API。Fetch 原生基于 Promise 体系构建,并引入了专门的 Request、Response、Headers 原语和 ReadableStream 数据流接口。它无需任何 npm 依赖安装,拥有 0 KB 的体积开销,是现代现代浏览器与 Node.js 18+ 的内置基建。
3. Axios:工程化场景下的高阶 HTTP 客户端
Axios 并不是浏览器的原生 API,而是一个构建在底层之上的同构 HTTP 请求库。在浏览器环境中,Axios 默认基于 XMLHttpRequest(利用其成熟的中断与进度事件);在 Node.js 环境中,它通过适配器架构自动切换为 Node 原生的 http / https 模块。Axios 的价值在于将工业级开发中必需的拦截器链、超时控制、数据自动序列化和统一异常体系封装为高层抽象。
二、代码模式与典型使用对比
我们通过一个标准的 POST JSON 请求,直观对比三者在编写代码时的风格差异与必要步骤。
1. XMLHttpRequest 实现方式
使用 XHR 发送请求时,开发者需要手动设置请求头、通过 JSON.stringify 序列化数据,并在 onload 回调中手动判断 HTTP 状态码并用 JSON.parse 反序列化响应文本:
const xhr = new XMLHttpRequest();
xhr.open('POST', '/api/users', true);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function () {
if (xhr.status >= 200 && xhr.status < 300) {
try {
const responseData = JSON.parse(xhr.responseText);
console.log('请求成功:', responseData);
} catch (e) {
console.error('JSON解析失败:', e);
}
} else {
console.error('服务器响应非2xx状态码:', xhr.status, xhr.statusText);
}
};
xhr.onerror = function () {
console.error('发生网络级别故障');
};
xhr.send(JSON.stringify({ name: '张三', role: 'admin' }));
2. Fetch API 实现方式
Fetch 使用 Promise 链式语法,语法上直观得多。但需要特别注意的是:Fetch 的请求体需要手动序列化,且对响应体的解析是一个二次异步过程(response.json() 会返回一个新的 Promise):
async function createUserWithFetch() {
try {
const response = await fetch('/api/users', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({ name: '张三', role: 'admin' })
});
// 注意:404/500 不会自动进入 catch,必须显式检查 ok
if (!response.ok) {
throw new Error(`请求失败,状态码: ${response.status}`);
}
const data = await response.json();
console.log('请求成功:', data);
} catch (error) {
console.error('捕获到错误:', error.message);
}
}
3. Axios 实现方式
Axios 自动处理对象序列化,并在接收到响应时根据 Content-Type 自动解析 JSON。当 HTTP 状态码不在 2xx 范围内时,它会自动抛出异常:
import axios from 'axios';
async function createUserWithAxios() {
try {
// 直接传入对象,自动序列化为 JSON,响应体直接挂载在 data 属性上
const response = await axios.post('/api/users', {
name: '张三',
role: 'admin'
});
console.log('请求成功:', response.data);
} catch (error) {
if (error.response) {
// 服务器响应了非 2xx 状态码 (例如 400, 404, 500)
console.error('接口报错:', error.response.status, error.response.data);
} else if (error.request) {
// 请求已发出但未收到响应 (网络断开或超时)
console.error('未收到响应:', error.message);
} else {
console.error('请求配置异常:', error.message);
}
}
}
三、容易混淆的关键机制深度辨析
在技术选型和日常排错中,有几个关于这三者的常见说法经常引起开发者的困惑。我们针对这些容易被误解的细节进行客观辨析。
这是日常开发中最常见的陷阱。实际上,Fetch 的 Promise 只有在遭遇网络层故障或请求被阻止时才会 reject(例如用户的设备断网、DNS 解析失败、或命中浏览器的跨域 CORS 拦截策略)。
只要目标服务器成功返回了响应报文——哪怕状态码是 404 Not Found、401 Unauthorized 还是 500 Internal Server Error——Fetch 返回的 Promise 都会正常 resolve,并返回一个 Response 对象。此时该对象的 response.ok 属性为 false。如果不主动写代码检查 if (!response.ok),程序就会误以为请求完全成功并继续执行下一步。
这个认知是不准确的。在 Axios 的核心架构中,为了提供对细粒度上传进度监听(onUploadProgress)和传统浏览器的完全兼容,Axios 浏览器端历史与默认的适配器是直接基于 XMLHttpRequest 实现的,而不是 Fetch。
Axios 之所以广受欢迎,核心在于它提供了一整套工程化机制:可链式插拔的请求与响应拦截器(interceptors)、统一取消请求控制器、自动防御 XSRF/CSRF 以及标准化的 AxiosError 错误结构。这些高层特性如果基于原生 Fetch 自行封装,往往需要编写数百行边界代码。
在绝大多数现代业务开发中,我们确实不再直接编写 new XMLHttpRequest()。但在特定的客户端文件上传进度监控场景中,XHR 仍然具有不可替代性。
XMLHttpRequest 原生提供了 xhr.upload.onprogress 事件,能够精确监听客户端向服务器推流上传的实时字节进度。而 Fetch API 规范中,虽然响应体支持 ReadableStream(可以精准监听下载进度),但对请求体流式上传进度的支持受限于浏览器的跨平台支持度与安全性规范,在主流生产环境中尚无法开箱即用地监听常规 POST 上传进度。因此,许多现代上传 SDK 在底层仍然保留着 XHR 的实现。
四、关键能力维度横向对比
为了更系统地评估三者在实际项目中的综合表现,我们将它们在核心功能维度上的表现汇总如下:
| 核心能力 | XMLHttpRequest | Fetch API (原生) | Axios (工程库) |
|---|---|---|---|
| 语法规范 | 基于事件与回调,嵌套繁重 | 原生标准 Promise,配合 async/await 简洁直观 | 链式 Promise 风格,提供简洁的辅助动词方法 |
| 状态码错误判定 | 需手动检测 xhr.status |
4xx/5xx 不自动 reject,需手动检查 response.ok |
默认对非 2xx 状态自动 reject,支持自定义判定规则 |
| 数据序列化 | 发送与接收均需手动调用 JSON 方法 | 发送需手动序列化,响应体需二次 await res.json() |
发送自动序列化,接收自动根据头信息转换为 JS 对象 |
| 拦截器机制 | 无原生支持,需强行重写原型方法 | 无内置概念,需自行封装高阶包装函数 | 原生支持双向管道拦截(请求/响应),支持挂载多个中间件 |
| 请求取消与超时 | xhr.abort() 与 xhr.timeout |
现代通过 AbortController 与 AbortSignal.timeout() |
直接配置 timeout 毫秒数,同时支持 AbortController |
| 上传进度监控 | 原生完全支持 (xhr.upload.onprogress) |
仅支持下载进度流,客户端上传进度支持不完善 | 原生封装支持 (onUploadProgress) |
| 跨端同构 (SSR) | 仅限浏览器端,Node.js 无法直接运行 | 现代浏览器原生;Node.js 18+ 原生内置 | 双适配器架构,浏览器端与 Node.js 核心网络栈完美通用 |
| 打包依赖体积 | 0 KB (浏览器内置宿主对象) | 0 KB (现代运行时内置标准) | 约 11 ~ 13 KB (Minified),Gzip 压缩后约 4.5 KB |
五、真实场景下的技术选型指南
选择哪种技术方案,本质上是在依赖包体积控制与开发工程化效率之间做权衡。以下结合实际工程场景给出具体的选型建议:
场景一:轻量前端项目、移动端 H5 与微前端子应用
首选方案:原生 Fetch API(搭配 20~30 行通用封装函数)
如果你的项目是一个对 首屏加载时间(FCP)极其敏感的移动端营销活动页、轻量小工具,或者是微前端体系中追求极小体积的子应用,引入额外的 HTTP 库会带来不必要的体积开销。现代浏览器已全面普及 Fetch,只需编写一个通用的 request 封装函数处理 response.ok 判断与 JSON 解析,即可满足绝大多数业务诉求。
场景二:中大型企业后台、复杂单页应用(SPA)与高频交互系统
首选方案:Axios
企业级系统通常具备统一的鉴权体系。例如:在请求拦截器中集中为每个请求注入 JWT Bearer Token;在响应拦截器中对后端返回的自定义业务错误码(如 code: 40101)进行全局弹窗提示;在 Token 过期时通过拦截器队列挂起请求并执行无感刷新(Refresh Token)。如果基于 Fetch 从头实现这一整套机制,需要处理请求队列锁、重试流转和错误结构归一化,容易引入边界漏洞。此时使用经过全球社区充分验证的 Axios,维护成本远低于自行造轮子。
场景三:具有大文件上传、分片上传与进度条监控的业务
首选方案:Axios 或底层 XMLHttpRequest
当系统涉及网盘、富媒体素材管理或大文件分块断点续传时,向用户实时展示真实的上传百分比是基本体验。由于 Fetch 缺乏简单稳定的上传进度事件支持,直接使用 Axios 的 onUploadProgress 参数是最稳妥的选择;若追求极致定制或开发独立的上传 SDK,也可以直接基于 XMLHttpRequest 编写底层模块。
场景四:全栈同构应用(SSR / Next.js / Nuxt)
选型策略:
- 如果团队在前端与后端(Node.js BFF 层)共用一套 API 模块或统一 SDK,使用 Axios 可以保证一套代码在客户端和服务端表现完全一致。
- 如果使用的是 Next.js 13+ App Router 等新型框架,框架本身在服务端对 原生 Fetch 进行了深度的缓存与数据重新验证机制扩展(
fetch(url, { next: { revalidate: 3600 } })),此时应当遵循框架规范优先使用框架增强版 Fetch。
六、总结与实践建议
回顾三种网络请求方案的技术脉络:
- XMLHttpRequest 功勋卓著,它奠定了现代前端异步交互的基石,但在现代应用开发中,除了底层上传进度监听和遗留系统维护外,不再推荐作为日常业务代码的首选。
- Fetch API 代表着现代 Web 的标准未来。它零开销、原生支持流式响应,但在使用时必须牢记手动检查
response.ok并妥善处理AbortController超时。 - Axios 依然是工程化开发中最省心、最完备的利器。它填补了原生标准与企业级生产需求之间的空白,适合对开发体验、拦截扩展性与多端一致性要求较高的团队。
在进行技术选型时,无需盲目追求“纯原生”或“唯第三方库”。根据项目的规模、体积预算以及是否需要复杂的拦截器流水线进行务实评估,才是最合理的工程决策。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。