You need to enable JavaScript to run this app. Django REST与React令牌认证重启开发服务后报401需重登?
优惠活动
大模型
产品
解决方案
定价
更多

Django REST与React令牌认证重启开发服务后报401需重登?

问题核心结论

这不是开发服务的默认行为,是前后端配置缺陷叠加开发环境的特殊触发条件导致的问题,仅在服务重启时复现的核心原因和令牌签名校验、前端请求头初始化逻辑直接相关。

问题根因分析

前端侧的配置缺陷

  • Axios实例的请求头初始化逻辑存在硬编码问题
    实例创建时直接在配置中写入Authorization: 'Bearer ' + localStorage.getItem('access_token'),这个值只在模块加载的瞬间读取一次localStorage内容,没有任何容错处理。一旦读取到的令牌值为null/空字符串,拼接生成的请求头就是无效格式(如Bearer null、Bearer ),后端解析头格式时就会抛出"Invalid token header. No credentials provided."的401错误。
    每次前端开发服务重启或热更新触发全量模块重载时,都会重新执行这段初始化逻辑,若存在存储读取时序差,就会生成无效请求头。
  • 响应拦截器的判断逻辑失效
    触发令牌刷新的判断条件依赖error.response.data.code字段匹配错误文本,但SimpleJWT、OAuth2认证类返回的401错误体根本不存在顶层code字段,实际错误内容存放在detail字段中。这导致拦截器的判断永远不成立,自动刷新令牌的逻辑完全无法触发——即使代码中写了刷新逻辑,也不会在遇到这类错误时执行。
  • 缺少请求级的头动态修正机制
    没有配置请求拦截器在每次发起请求前动态读取最新的本地令牌,一旦初始化阶段生成了错误的请求头,后续所有请求都会沿用这个错误值,不会主动修正。

很多时候你在浏览器网络面板看到请求确实携带了有效令牌,是因为拦截器重发的重试请求已经替换了新令牌,但最开始触发401的原始请求,头是用初始化时读到的空值拼接的无效格式,因此会被后端判定为无有效凭据。

后端侧的配置缺陷

  • 开发环境未固定SECRET_KEY
    若Django settings中没有明确配置固定的SECRET_KEY,runserver每次启动时都会随机生成一个临时签名密钥。此前服务运行时签发的所有JWT/OAuth2令牌,都是基于旧的SECRET_KEY签名的,新启动的服务无法通过签名校验,这也是问题仅在服务启动后复现的核心触发条件——服务运行过程中SECRET_KEY不变,令牌校验正常,一旦重启就会导致所有存量令牌失效。
  • 认证类顺序不合理
    DRF配置的认证类顺序中,OAuth2、社交认证类排在SimpleJWT之前,这类类在解析请求头时,若遇到不符合自身格式的令牌,可能会提前抛出认证错误,干扰JWT的正常校验流程。
修复方案

前端侧修复

  • 移除Axios实例初始化时硬编码的Authorization头,替换为请求拦截器动态生成请求头的逻辑:
    // 新增请求拦截器,每次发请求前动态读取最新令牌
    axiosInstance.interceptors.request.use((config) => {
        const token = localStorage.getItem('access_token');
        if (token) {
            config.headers.Authorization = `Bearer ${token}`;
        } else {
            // 无令牌时直接移除无效的Authorization头,避免生成错误格式
            delete config.headers.Authorization;
        }
        return config;
    })
    
  • 修正响应拦截器的刷新触发逻辑,移除对不存在的code字段的依赖,只要遇到401错误、且当前请求不是刷新接口本身、且没有重试过,就触发令牌刷新流程:
    // 替换原来的错误判断逻辑
    if (
        error.response.status === 401 &&
        originalRequest.url !== `${baseURL}auth/token/` &&
        !originalRequest._retry
    ) {
        originalRequest._retry = true;
        // 后续的令牌刷新、重放请求逻辑保持原有实现即可
    }
    

后端侧修复

  • 固定Django的SECRET_KEY,可通过环境变量加载固定值写入settings,确保服务重启后签名密钥不变化,存量令牌可以正常通过校验。
  • 调整DRF认证类的顺序,将SimpleJWT认证类放到最优先的位置,减少其他认证类对请求头解析的干扰:
    REST_FRAMEWORK = {
        'DEFAULT_PERMISSION_CLASSES': [
            'rest_framework.permissions.IsAuthenticated',
        ],
        'DEFAULT_AUTHENTICATION_CLASSES': (
            'rest_framework_simplejwt.authentication.JWTAuthentication',
            'oauth2_provider.contrib.rest_framework.OAuth2Authentication',
            'drf_social_oauth2.authentication.SocialAuthentication',
        )
    }
    

内容的提问来源于stack exchange,提问作者yung peso

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 20:45:04