Django Simple JWT中实现健壮的刷新令牌轮换与页面刷新策略

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Django Simple JWT中实现健壮的刷新令牌轮换与页面刷新策略

2025-11-12

浏览次数：次

返回列表

Django Simple JWT中实现健壮的刷新令牌轮换与页面刷新策略

本文探讨django simple jwt中刷新令牌轮换可能导致的竞态条件，特别是当用户快速刷新页面时。核心解决方案是避免在页面刷新时触发令牌刷新，而是依赖现有的访问令牌。当访问令牌过期时，前端应通过同步的令牌刷新机制处理401错误，确保并发请求的可靠性，并在刷新令牌最终过期时引导用户重新认证。

Django Simple JWT提供了一种方便且安全的JWT认证机制。为了增强安全性，通常会启用刷新令牌轮换（ROTATE_REFRESH_TOKENS）并立即将旧令牌列入黑名单（BLACKLIST_AFTER_ROTATION）。然而，这种配置在特定场景下，如用户频繁刷新页面或存在并发请求时，可能引发竞态条件，导致用户意外登出。

理解刷新令牌轮换的挑战

Django Simple JWT的ROTATE_REFRESH_TOKENS和BLACKLIST_AFTER_ROTATION设置旨在提高安全性，通过为每个刷新请求颁发新令牌并废弃旧令牌来减少令牌被盗用的风险。

ROTATE_REFRESH_TOKENS: True：每次使用刷新令牌获取新的访问令牌时，都会生成一个新的刷新令牌。
BLACKLIST_AFTER_ROTATION: True：旧的刷新令牌在使用后立即被列入黑名单，使其失效。

当用户在极短时间内多次刷新页面，或者前端有多个并发请求同时检测到访问令牌过期并尝试刷新时，就可能出现问题。如果客户端在收到新的刷新令牌之前，其持有的旧刷新令牌已被服务器列入黑名单，那么后续的刷新请求将失败，导致用户会话中断。

健壮的令牌管理策略：访问令牌优先，同步刷新兜底

解决上述竞态条件的关键在于改变对页面刷新和令牌过期的处理方式。

1. 页面刷新不应触发令牌刷新

核心原则是：页面刷新不应直接触发刷新令牌的请求。当用户刷新页面时，前端应尝试使用HTTP-only cookie中现有的访问令牌去请求受保护的资源。如果访问令牌有效，请求将成功；如果访问令牌过期，后端会返回401未授权响应。

2. 处理访问令牌过期：前端同步刷新机制

当后端返回401未授权响应时，前端需要介入并执行令牌刷新。为了避免竞态条件，尤其是在有多个并发请求的场景下，前端必须实现一个同步的令牌刷新机制。

同步刷新机制的工作原理：

拦截并暂停请求： 当任何一个请求收到401响应时，将其暂停并排队。
触发一次刷新： 仅发起一次刷新令牌的请求。
等待刷新结果： 所有后续收到401的请求都会加入到这个等待队列中，而不是各自发起新的刷新请求。
更新令牌并重试： 一旦刷新令牌请求成功，获取到新的访问令牌和刷新令牌（并更新HTTP-only cookie），则使用新的访问令牌重试所有排队中的请求。
处理刷新失败： 如果刷新令牌本身也过期或无效（例如，收到invalid_grant错误），则所有排队请求失败，并引导用户重新登录。

这种机制确保了即使有多个并发请求，也只会执行一次令牌刷新操作，从而有效避免了旧刷新令牌在新的刷新令牌到达之前被黑名单的竞态条件。

千鹿Pr助手

智能Pr插件，融入众多AI功能和海量素材

128 查看详情千鹿Pr助手

示例（React.js + Axios 拦截器概念代码）：

在React.js应用中，通常会使用Axios等HTTP客户端库，并通过其拦截器功能来实现这一逻辑。

// authService.js
import axios from 'axios';

let isRefreshing = false;
let failedQueue = [];

// 处理等待队列中的请求
const processQueue = (error, token = null) => {
  failedQueue.forEach(prom => {
    if (error) {
      prom.reject(error);
    } else {
      prom.resolve(token);
    }
  });
  failedQueue = [];
};

// 创建Axios实例
const api = axios.create({
  baseURL: '/api', // 你的API基础URL
  withCredentials: true, // 允许发送和接收cookie
});

// 添加响应拦截器
api.interceptors.response.use(
  response => response,
  async error => {
    const originalRequest = error.config;
    // 如果错误响应是401且不是我们自己的刷新令牌请求（通过_retry标记判断）
    if (error.response.status === 401 && !originalRequest._retry) {
      if (isRefreshing) {
        // 如果正在刷新，将当前请求加入队列等待
        return new Promise(function(resolve, reject) {
          failedQueue.push({ resolve, reject });
        })
        .then(token => {
          // 这里的token是占位符，因为HTTP-only cookie是自动处理的
          // 实际操作是重试原始请求，浏览器会自动带上新的cookie
          return api(originalRequest);
        })
        .catch(err => {
          return Promise.reject(err);
        });
      }

      originalRequest._retry = true; // 标记此请求已尝试过刷新
      isRefreshing = true; // 设置刷新状态为正在进行

      return new Promise(async (resolve, reject) => {
        try {
          // 尝试刷新令牌
          // 后端刷新令牌的API，通常是POST请求，cookie会自动携带
          const refreshResponse = await axios.post('/api/auth/token/refresh/', {}, { withCredentials: true });

          // 假设后端在成功刷新后会设置新的HTTP-only cookie
          // 前端不需要直接处理令牌值，只需要确保cookie已更新即可

          isRefreshing = false; // 刷新完成
          processQueue(null, 'new_access_token_placeholder'); // 通知所有排队请求刷新成功
          resolve(api(originalRequest)); // 重试原始请求
        } catch (refreshError) {
          isRefreshing = false; // 刷新失败
          processQueue(refreshError); // 通知所有排队请求刷新失败
          // 刷新令牌也过期或无效，引导用户重新登录
          // 例如：window.location.href = '/login';
          reject(refreshError);
        }
      });
    }
    return Promise.reject(error);
  }
);

export default api;

注意事项：

上述代码中的'new_access_token_placeholder'是一个占位符。由于访问令牌通常存储在HTTP-only cookie中，前端不会直接访问其值。api(originalRequest)在重试时会自动发送更新后的cookie。
刷新令牌的请求本身不应被拦截器处理，或应有特殊标记避免循环。!originalRequest._retry是为此目的。

3. 处理刷新令牌过期：重新认证

最终，刷新令牌本身也会过期。当刷新令牌过期时，后端在尝试刷新时会返回一个类似于invalid_grant的错误代码（Django Simple JWT通常会返回401，但错误详情可能指示刷新令牌无效）。在这种情况下，前端应清除所有本地会话信息（如果有的话），并将用户重定向到登录页面，要求他们重新进行完整的认证流程。