Vue项目中有封装过axios吗?怎么封装的?
参考答案
封装目标
统一 baseURL、超时、鉴权、错误处理、取消请求、loading、日志,业务层只关心「拿数据」。
典型封装(Vue 3 + axios)
// utils/request.js
import axios from 'axios'
import { ElMessage } from 'element-plus'
const request = axios.create({
baseURL: import.meta.env.VITE_API_BASE,
timeout: 10000,
headers: { 'Content-Type': 'application/json' },
})
// 请求拦截:加 token、traceId
request.interceptors.request.use(cfg => {
const token = localStorage.getItem('token')
if (token) cfg.headers.Authorization = `Bearer ${token}`
cfg.headers['X-Request-Id'] = crypto.randomUUID()
return cfg
})
// 响应拦截:拆 data、统一错误
request.interceptors.response.use(
res => {
const { code, data, message } = res.data
if (code === 0 || code === 200) return data // 直接返回业务数据
if (code === 401) { useUserStore().logout(); router.push('/login') }
ElMessage.error(message || '请求失败')
return Promise.reject(new Error(message))
},
err => {
if (axios.isCancel(err)) return Promise.reject(err) // 主动取消不提示
const msg = err.code === 'ECONNABORTED' ? '请求超时' : '网络异常'
ElMessage.error(msg)
return Promise.reject(err)
}
)
export default request
分层设计(更工程化)
api/user.js // 只声明接口:export const getUser = id => request.get(`/user/${id}`)
composables/useRequest.js // 通用请求 hook:loading/error/refresh/缓存/取消
views/* // 只调用 api 层,不直接 import axios
useRequest 示例能力:loading、error、data、refresh、debounce、cancel、onSuccess/onError、依赖自动请求。
要点
- 返回业务数据而不是整个 response,减少业务层
res.data.data嵌套; - 统一错误提示与鉴权失效处理(401 跳登录、刷新 token);
- 取消重复请求:
AbortController或维护 pending 的 Map,路由切换时取消; - 并发与重试:幂等 GET 可加指数退避重试;
- 类型:TS 定义
ApiResponse<T>; - 上传/下载:单独封装
responseType: 'blob'与进度回调; - Mock:开发期用 mock 拦截,联调切换 baseURL;
- 不要把所有逻辑塞进拦截器,业务语义(如「弹窗确认」)留在业务层。