如何在vue3项目中使用 AbortController取消axios请求

在 Vue3 项目中通过 AbortController 取消 Axios 请求,可以通过以下 结构化步骤 实现。我们结合组合式 API(Composition API)和现代前端实践演示:

一、基础实现(单个请求)

1. 创建组件逻辑
TypeScript 复制代码
<script setup>
import { ref, onBeforeUnmount } from 'vue';
import axios from 'axios';

// 存储 AbortController 实例
const abortController = ref(null);
const data = ref(null);
const error = ref(null);
const isLoading = ref(false);

// 发送请求方法
const fetchData = async () => {
  isLoading.value = true;
  error.value = null;
  
  // 如果存在旧请求,先取消
  if (abortController.value) {
    abortController.value.abort();
  }

  // 创建新控制器
  abortController.value = new AbortController();

  try {
    const response = await axios.get('/api/data', {
      signal: abortController.value.signal
    });
    data.value = response.data;
  } catch (err) {
    // 重点:识别取消错误
    if (err.name === 'CanceledError' || axios.isCancel(err)) {
      console.log('请求被主动取消');
    } else {
      error.value = err.message;
    }
  } finally {
    isLoading.value = false;
    abortController.value = null; // 清理控制器
  }
};

// 组件卸载时自动取消
onBeforeUnmount(() => {
  if (abortController.value) {
    abortController.value.abort();
  }
});
</script>

<template>
  <button @click="fetchData" :disabled="isLoading">
    {{ isLoading ? '加载中...' : '获取数据' }}
  </button>
  <button @click="abortController?.abort()" :disabled="!isLoading">
    取消请求
  </button>
  
  <div v-if="data">{{ data }}</div>
  <div v-if="error" class="error">{{ error }}</div>
</template>

二、进阶实现(多个并行请求)

1. 封装可复用 Hook
TypeScript 复制代码
// src/composables/useAbortController.js
import { onBeforeUnmount } from 'vue';

export default function useAbortController() {
  const controllers = new Map(); // 用 Map 存储多个控制器

  // 添加控制器
  const createSignal = (requestId) => {
    const controller = new AbortController();
    controllers.set(requestId, controller);
    return controller.signal;
  };

  // 取消特定请求
  const abortRequest = (requestId) => {
    if (controllers.has(requestId)) {
      controllers.get(requestId).abort();
      controllers.delete(requestId);
    }
  };

  // 自动清理
  onBeforeUnmount(() => {
    controllers.forEach(controller => controller.abort());
    controllers.clear();
  });

  return { createSignal, abortRequest };
}
2. 在组件中使用
TypeScript 复制代码
<script setup>
import { ref } from 'vue';
import axios from 'axios';
import useAbortController from '@/composables/useAbortController';

const { createSignal, abortRequest } = useAbortController();
const userData = ref(null);
const postData = ref(null);

// 并行发送多个请求
const fetchAllData = async () => {
  try {
    const [usersRes, postsRes] = await Promise.all([
      axios.get('/api/users', {
        signal: createSignal('users') // 唯一标识
      }),
      axios.get('/api/posts', {
        signal: createSignal('posts')
      })
    ]);
    
    userData.value = usersRes.data;
    postData.value = postsRes.data;
  } catch (err) {
    if (!err.name.includes('Cancel')) {
      console.error('请求失败:', err);
    }
  }
};

// 手动取消用户数据请求
const cancelUsers = () => abortRequest('users');
</script>

<template>
  <button @click="fetchAllData">加载全部数据</button>
  <button @click="cancelUsers">取消用户数据请求</button>
</template>

三、最佳实践要点

1. 错误处理规范
TypeScript 复制代码
try {
  // ...请求逻辑
} catch (err) {
  if (err.name === 'CanceledError' || axios.isCancel(err)) {
    console.log('请求取消:', err.message);
    return; // 明确终止后续处理
  }
  
  // 其他错误处理
  if (err.response?.status === 404) {
    // 处理 404
  } else {
    // 通用错误
  }
}
2. 自动取消优化

在路由切换时自动取消所有请求:

TypeScript 复制代码
// src/router.js
import { createRouter } from 'vue-router';
import { useAbortController } from '@/composables/useAbortController';

const router = createRouter({...});

// 路由守卫中全局取消
router.beforeEach(() => {
  const { abortAll } = useAbortController();
  abortAll(); // 需要扩展 Hook 功能
});
3. TypeScript 类型支持
TypeScript 复制代码
// types/abort.d.ts
import type { AxiosRequestConfig } from 'axios';

declare module 'axios' {
  export interface AxiosRequestConfig {
    signal?: AbortSignal;
    requestId?: string; // 自定义标识
  }
}

四、常见问题解决

1. 取消无效问题
  • 检查 Axios 版本 :确保使用 axios@0.22.0+

  • 验证信号传递 :确认请求配置中正确传递了 signal

  • 避免重复使用控制器:每个请求必须使用新实例

2. 内存泄漏预防
TypeScript 复制代码
// 在组件卸载时清理
onBeforeUnmount(() => {
  abortController.value?.abort();
  controllers.clear(); // 对于 Map 存储的情况
});
3. 浏览器兼容性
TypeScript 复制代码
# 安装 polyfill(如需支持 IE11)
npm install abortcontroller-polyfill
TypeScript 复制代码
// main.js
import 'abortcontroller-polyfill/dist/abortcontroller-polyfill-only';

通过这种设计,你可以实现:

  • ✅ 组件级自动请求取消

  • ✅ 精细化的多请求管理

  • ✅ 符合 Vue3 响应式特性的状态管理

  • ✅ 完善的 TypeScript 类型支持

相关推荐
Mh5 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳6 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔6 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart7 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt8 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑8 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星9 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson9 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼10 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊10 小时前
CNC计算机数控加工模拟器
前端