Vue 3 中所有请求自动携带 Token 的核心是通过 Axios 请求拦截器统一注入,即从 localStorage 或 Pinia 读取 token 并设为 Authorization: Bearer ${token},同时用响应拦截器处理 401 过期并跳转登录。

在 Vue 3 项目中,让所有请求自动携带 Token,核心是通过 Axios 请求拦截器统一注入,而不是每个接口手动加。关键在于:从存储(如 localStorage 或 Pinia)读取 token,并按后端约定格式写入 Authorization 请求头。
请求拦截器:自动注入 Token 到 Header
这是最主流、最推荐的做法。所有使用封装后的 axios 实例发起的请求,都会经过这里处理:
- 创建 axios 实例时调用
interceptors.request.use - 从本地获取 token(比如
localStorage.getItem('token')或useUserStore().token) - 若存在 token,设置
config.headers.Authorization = `Bearer ${token}`(注意大小写和空格,“Bearer”后必须有一个空格) - 务必 return config,否则请求会中断
Token 存储位置影响读取方式
你把 token 存哪儿,就从哪儿读:
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
-
localStorage / sessionStorage:简单直接,适合多数场景
const token = localStorage.getItem('token') -
Pinia / Vuex 状态管理:更利于响应式控制和集中维护
const userStore = useUserStore(); const token = userStore.token -
HTTP-only Cookie:安全性更高,但前端无法直接读取,此时通常不需手动加 header,由浏览器自动携带(需后端配置
withCredentials: true)
响应拦截器:配合处理 Token 过期(401)
光加 token 不够,还要应对它失效的情况。响应拦截器负责兜底:
立即学习“前端免费学习笔记(深入)”;
- 检查
response.status === 401或后端自定义错误码(如data.code === 401) - 清空本地 token 和用户信息(
localStorage.removeItem('token')) - 跳转登录页,可附带当前路由(
router.push({ path: '/login', query: { redirect: router.currentRoute.value.fullPath } })) - 如果要做“无感刷新”,则在此处触发 refresh_token 请求,成功后再重发原请求(需额外队列机制,避免并发重复刷新)
注意事项与常见坑
几个容易出错但很关键的点:
-
header 字段名大小写敏感:推荐写
config.headers.Authorization,不是authorization或auth -
Bearer 后必须有空格:写成
`Bearer${token}`会失败,正确是`Bearer ${token}` - 避免在登录接口本身加 token:登录请求不该带 token,否则形成死循环;可在请求前判断 URL 是否为登录地址,跳过注入
-
确保 axios 实例被全局使用:组件里 import 的必须是你封装好拦截器的那个实例(如
import request from '@/utils/request'),而不是直接 import axios

















