17370845950

fetch默认不带Cookie、不自动抛错、无超时，需手动处理credentials、res.ok校验及AbortController；axios则默认更友好但响应数据在response.data中。

fetch 基本用法和常见陷阱

fetch 是浏览器原生 API，不用额外安装，但默认不带 Cookie、不自动抛错、不支持超时——这些都得手动处理。

最简 GET 请求看起来干净，但实际项目里几乎 always 需要配置 credentials 和错误判断：

fetch('/api/user', {
  method: 'GET',
  credentials: 'include', // 不加这句，跨域请求不会带 cookie
  headers: {
    'Accept': 'application/json'
  }
})
.then(res => {
  if (!res.ok) throw new Error(`HTTP ${res.status}`); // fetch 不会因 4xx/5xx 自动 reject
  return res.json();
})
.catch(err => console.error('请求失败:', err));

• res.ok 只判断状态码是否在 200–299，401、500 都算“成功”返回，必须手动检查
• POST 提交 JSON 时，必须同时设 headers['Content-Type'] = 'application/json' 和 body: JSON.stringify(data)
• 没有内置超时机制，需用 AbortController 控制（见下一条）

fetch 如何加超时和取消

fetch 本身不支持 timeout 参数，得靠 AbortController 配合 Promise.race 模拟：

function fetchWithTimeout(url, options = {}, timeout = 5000) {
  const controller = new AbortController();
  const id = setTimeout(() => controller.abort(), timeout);

  return fetch(url, { ...options, signal: controller.signal })
    .finally(() => clearTimeout(id));
}

// 使用
fetchWithTimeout('/api/data', { method: 'POST', body: JSON.stringify({x:1}) })
  .then(res => res.json())
  .catch(err => {
    if (err.name === 'AbortError') console.error('请求超时');
    else console.error('其他错误:', err);
  });

• controller.abort() 触发后，fetch Promise 会以 AbortError 拒绝，不是网络错误或 HTTP 错误
• 务必在 .finally 清掉定时器，否则可能内存泄漏
• 注意：signal 在 Node.js（v18+）也支持，但老版不兼容

axios 的默认行为比 fetch “更像人”

axios 默认发送 Content-Type: application/json（对 JS 对象）、自动转换响应体、自带超时、默认携带 cookie（同源时），适合快速落地。

但要注意它把响应数据包在 response.data 里，不是直接返回解析后的结果：

axios.get('/api/profile')
  .then(response => {
    console.log(response.data); // ✅ 正确：后端返回的 JSON 已自动解析
    console.log(response.status); // ✅ 状态码
    console.log(response.headers); // ✅ 响应头
  })
  .catch(error => {
    if (error.code === 'ECONNABORTED') console.log('请求超时');
    else if (error.response) console.log('HTTP 错误:', error.response.status);
    else console.log('网络错误:', error.message);
  });

• axios.defaults.timeout = 10000 可全局设超时，比 fetch 每次写 AbortController 省事
• 拦截器（axios.interceptors.request.use）适合统一加 token，但别在其中 throw 错误，否则会中断整个链路
• 不推荐用 axios.create() 配一堆重复 config，除非真有多个不同 base URL 的服务

选 fetch 还是 axios？关键看三点

不是“哪个更好”，而是“当前项目卡在哪”：

• 只跑现代浏览器、且团队坚持零依赖？用 fetch + 封装一层工具函数（比如加超时、自动 res.json()、统一错误格式）
• 要兼容 IE 或需要上传进度、取消重复请求、响应转换等开箱功能？axios 省三天调试时间
• 用 React Query / SWR 等数据层库？它们底层可插拔，fetch 或 axios 都能接，但默认倾向 fetch；此时选哪个，取决于你是否已有 axios 实例和拦截逻辑

真正容易被忽略的是：无论用哪个，**HTTP 状态码语义、重试策略、错误降级 UI、Loading 状态边界**，这些从来不在 fetch 或 axios 的 API 里，得你自己串起来。