Vue-Vben-Admin项目中Axios请求防抖的实现与优化

前言

在Vue-Vben-Admin项目中，前端开发经常会遇到需要防止重复请求的问题。特别是在用户快速点击按钮或频繁触发请求的场景下，如果不加以控制，会导致服务器接收大量重复请求，不仅浪费资源，还可能引起数据不一致的问题。本文将深入探讨如何在项目中实现优雅的请求防抖机制。

请求防抖的核心原理

请求防抖的核心思想是：当检测到相同的请求正在处理时，取消后续的重复请求。这需要解决三个关键问题：

1. 如何唯一标识一个请求
2. 如何存储和管理进行中的请求
3. 如何取消重复请求

实现方案分析

在Vue-Vben-Admin项目中，采用了基于Axios拦截器的实现方案，主要包含以下组件：

1. 请求标识生成

通过组合请求方法、URL、参数和数据来生成唯一标识：

const url = [
  config.method,
  config.url,
  qs.stringify(config.params),
  qs.stringify(config.data)
].join("&");

这种组合方式能够确保不同参数、不同方法的请求被视为不同的请求。

2. 请求管理机制

使用Map数据结构来存储进行中的请求：

const pending = new Map<string, () => void>();

Map的键是生成的请求标识，值是对应的取消函数。

3. 拦截器实现

请求拦截器

在请求发出前执行两个操作：

1. 检查是否有相同请求正在处理，有则取消
2. 将当前请求添加到pending Map中

function requestInterceptor() {
  return {
    fulfilled: (config) => {
      removePending(config);
      addPending(config);
      return config;
    }
  };
}

响应拦截器

在请求完成后（无论成功或失败），从pending Map中移除对应的请求：

function responseInterceptor() {
  return {
    fulfilled: (response) => {
      removePending(response.config);
      return response;
    },
    rejected: (error) => {
      if (error?.config) {
        removePending(error.config);
      }
      return Promise.reject(error);
    }
  };
}

实现细节优化

取消函数处理

在取消请求时，直接调用存储的取消函数：

const cancel = pending.get(url);
cancel?.(); // 安全调用取消函数

错误处理

在响应拦截器的rejected分支中，需要检查error对象是否包含config属性，避免空指针异常。

替代方案：Vue Query

虽然Axios拦截器方案能够有效防止重复请求，但项目协作者也提出了使用Vue Query的替代方案。Vue Query提供了更高级的请求管理功能：

1. 自动缓存请求结果
2. 内置重复请求去重
3. 更细粒度的缓存控制
4. 自动重试机制

使用Vue Query可以简化代码，同时获得更好的开发体验和性能优化。

总结

在Vue-Vben-Admin项目中，请求防抖是一个重要的优化点。通过Axios拦截器实现的方案具有以下特点：

1. 实现简单，不依赖额外库
2. 对现有代码侵入性小
3. 能够有效防止重复请求

而对于更复杂的应用场景，可以考虑使用Vue Query等专门的状态管理库，它们提供了更全面的解决方案。开发者应根据项目实际需求和复杂度选择合适的方案。