Vue 3响应拦截器不直接刷新令牌,而是捕获401后触发刷新逻辑、更新token并重试请求;需用refreshPromise锁避免并发刷新冲突;新token由后端返回并由前端持久化。

Vue 3 中响应拦截器本身不能“静默更新刷新令牌”,它只负责处理响应结果;真正完成刷新令牌动作的是前端主动发起的请求。所谓“后台静默更新”,其实是前端在响应拦截器中捕获到 token 过期信号(如 401 状态码)后,自动用 refresh token 向后端发起刷新请求,并在成功后更新本地存储、重试原请求——整个过程不打断用户操作,所以叫“无感”或“静默”。
响应拦截器的核心职责是识别、拦截与调度
它不直接更新 refresh token,而是做三件事:
- 判断响应是否因 access token 过期导致失败(通常是 status === 401 且非刷新接口)
- 触发刷新逻辑(调用封装好的 refreshToken 接口)
- 成功后更新 store 或 localStorage 中的 access token 和 refresh token,并重发原始请求
关键:避免并发刷新导致的 token 覆盖问题
多个请求几乎同时过期时,若都触发刷新,可能造成多次请求、token 被覆盖、甚至刷新失败。正确做法是引入“刷新锁”机制:
- 用一个 Promise 变量(如 let refreshPromise = null)缓存首次刷新请求
- 后续过期请求不再重复发起刷新,而是 await 同一个 Promise
- 刷新完成后统一 resolve,所有等待中的请求拿到新 token 并重试
refresh token 的更新发生在刷新接口响应中
后端在成功验证 refresh token 后,应返回新的 access token 和(可选的)新的 refresh token。前端需在刷新接口的响应处理中提取并持久化它们:
- 从响应头(如 Authorization、Refresh-Token)或响应体中提取新 token
- 调用 Pinia store 的 setToken() 和 setRefreshToken() 方法更新状态
- 确保后续请求拦截器能读取到最新值
注意 refresh token 本身一般不“自动轮换”,但建议支持
为提升安全性,理想方案是后端每次刷新都签发一对新 token,并作废旧 refresh token(例如存入 Redis 黑名单)。前端无需主动“更新”它,只需信任后端返回的新值并及时替换。若后端未返回新 refresh token,前端不应自行延长其有效期——这会削弱安全设计。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











