不能直接在layui全局配置加token刷新逻辑,因其无响应拦截器机制,error回调中手动刷新会导致并发重复请求和回调嵌套地狱;需用全局锁+队列串行化处理401,并封装apiRequest统一拦截,且refresh_token必须HttpOnly Cookie存储。

为什么不能直接在 layui 的 ajax 全局配置里加 token 刷新逻辑
因为 layui 的 layui.use('jquery') 或 layui.ajax(实际是封装的 jQuery.ajax)没有原生的「响应拦截器」机制,不像 axios 那样能统一捕获 401 并阻塞后续请求、排队重试。你如果只在 error 回调里调用刷新接口,再手动重发原请求,会面临两个硬伤:并发请求全部触发刷新、多个 401 堆叠导致重复调用 /refresh 接口;原请求上下文(比如回调函数、data 参数、success 处理逻辑)无法自动还原,容易写成嵌套地狱。
必须用一个全局刷新锁 + 请求队列来串行化 401 处理
核心是避免多请求同时撞上过期,都去刷 token。你需要一个状态标记和一个待执行队列:
-
isRefreshing:布尔值,表示当前是否正在刷新 token,初始为false -
pendingRequests:数组,存下所有等待新 token 的原始请求配置(含url、type、data、success、error等) - 首次遇到
401时,若!isRefreshing,则发起refreshToken请求;否则把当前请求 push 进pendingRequests -
refreshToken成功后,更新本地存储的access_token,然后遍历pendingRequests逐个重发
注意:refreshToken 接口必须返回新的 access_token(且最好也返回新 refresh_token 用于轮换),不能只返回成功状态。
layui.ajax 的 request 拦截只能靠手动包装,别碰全局 setup
layui 没有类似 axios.interceptors.request 的钩子,所以不能改写所有请求行为。正确做法是封装一个自己的 apiRequest 函数,在里面统一加 header、处理 401,并暴露给业务代码调用:
function apiRequest(options) {
const token = localStorage.getItem('access_token');
if (token) {
options.headers = options.headers || {};
options.headers.Authorization = 'Bearer ' + token;
}
return layui.jquery.ajax({
...options,
error: function(xhr, status, err) {
if (xhr.status === 401) {
handle401Error(options);
} else if (options.error) {
options.error(xhr, status, err);
}
}
});
}
关键点:handle401Error 就是上面说的带锁+队列的逻辑;所有业务层的 layui.ajax 调用都要换成 apiRequest,否则无感刷新不生效。
Refresh Token 必须 HttpOnly + Secure Cookie 存储,别放 localStorage
这是最容易被忽略的安全雷区。如果你把 refresh_token 存在 localStorage,XSS 攻击可直接读取并永久续期,等于白做双 Token。正确方式是后端在登录/刷新成功响应头中设置:
Set-Cookie: refresh_token=xxx; HttpOnly; Secure; SameSite=Strict; Path=/api/auth
前端完全不用管它怎么存——浏览器自动携带,apiRequest 发起 /api/auth/refresh 时自然带上。而 access_token 可以存在内存或 localStorage(因为它有效期短,且只用于 header),但绝不能存 refresh_token。
复杂点在于:一旦你用了 HttpOnly Cookie,就无法在 JS 中读取它来做“是否已登录”的判断,得靠一个轻量 /api/auth/me 接口兜底,或者依赖首次登录后服务端渲染的初始状态。


















