You need to enable JavaScript to run this app. Django自定义LoginRequiredMiddleware路由认证失效问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Django自定义LoginRequiredMiddleware路由认证失效问题求助

常见问题定位

1. 中间件注册顺序错误

Django 中间件执行严格遵循MIDDLEWARE配置列表的顺序:请求进入时从上到下触发各中间件的请求处理逻辑,响应返回时从下到上触发各中间件的响应处理逻辑。
自定义登录校验中间件必须放置在以下两个系统中间件的后方,否则逻辑完全失效:

  • django.contrib.sessions.middleware.SessionMiddleware:负责解析请求携带的session信息
  • django.contrib.auth.middleware.AuthenticationMiddleware:负责从session中提取用户信息,将认证状态绑定到request.user对象
    如果顺序错位,会出现两类异常:
  • 调试模式下触发代码中编写的assert hasattr(request, 'user')断言错误
  • 生产模式(DEBUG=False)下assert语句被自动跳过,此时request.user未完成登录态初始化,判断逻辑要么误拦截已登录用户,要么完全不拦截未登录请求。

2. 白名单正则匹配范围过大

当前代码的白名单配置存在逻辑bug:

  • 概念混淆:错误将Django配置LOGIN_REDIRECT_URL(登录成功后默认跳转的业务页面)作为白名单路径
  • 正则规则过宽:编译的正则仅移除路径开头的斜杠,只要请求路径开头和白名单字符串一致就会命中豁免规则。比如白名单值为admin时,所有admin/开头的路径——包括你需要认证的后台受限页面——都会被直接放行,自然出现未登录即可访问的问题。

3. 安全校验参数传参错误

调用is_safe_url时,allowed_hosts参数传入的是request.get_host()(单个主机名字符串),但Django接口要求该参数传入可迭代的主机集合,直接传字符串会被拆成单个字符做匹配,安全校验完全失效,存在开放重定向漏洞。

4. 重定向路径逻辑混淆

拼接登录跳转地址时,硬把登录路径拼接到LOGIN_REDIRECT_URL后面,没有使用Django标准的LOGIN_URL配置,会导致跳转地址和实际登录页路径不匹配。


修正后的标准实现

调整逻辑后,统一使用Django内置认证配置,白名单仅覆盖无需认证的公开路径,修正后的middleware.py代码如下:

from django.conf import settings
from django.http import HttpResponseRedirect
from django.utils.deprecation import MiddlewareMixin
from django.utils.http import is_safe_url
from django.urls import reverse
from urllib.parse import urlencode
import re

# 全局豁免白名单:仅放明确不需要登录即可访问的路径
EXEMPT_URLS = [
    re.compile(r'^accounts/login/$'),  # 登录页本身
    re.compile(r'^static/'),           # 静态资源
    re.compile(r'^media/'),            # 上传的媒体文件
    re.compile(r'^healthcheck/$'),     # 服务健康检查接口
]

class LoginRequiredMiddleware(MiddlewareMixin):
    def process_request(self, request):
        # 已认证用户直接放行
        if request.user.is_authenticated:
            return None
        
        # 格式化当前请求路径
        path = request.path_info.lstrip('/')
        
        # 命中白名单的路径直接放行
        if any(m.match(path) for m in EXEMPT_URLS):
            return None
        
        # 解析登录页地址,支持配置为命名路由的场景
        login_url = settings.LOGIN_URL
        try:
            login_url = reverse(login_url)
        except:
            pass
        
        # 校验next参数的安全性,避免开放重定向
        redirect_params = {}
        if request.path_info != login_url:
            if is_safe_url(
                url=request.path_info,
                allowed_hosts={request.get_host()},
                require_https=request.is_secure()
            ):
                redirect_params['next'] = request.path_info
        
        # 拼接最终跳转地址
        if redirect_params:
            return HttpResponseRedirect(f"{login_url}?{urlencode(redirect_params)}")
        return HttpResponseRedirect(login_url)

落地验证注意事项
  • 调整settings.py中MIDDLEWARE的顺序,保证自定义登录中间件位于SessionMiddleware、AuthenticationMiddleware之后,正确顺序参考:
    MIDDLEWARE = [
        'django.middleware.security.SecurityMiddleware',
        'django.contrib.sessions.middleware.SessionMiddleware',
        'django.middleware.common.CommonMiddleware',
        'django.middleware.csrf.CsrfViewMiddleware',
        'django.contrib.auth.middleware.AuthenticationMiddleware',
        # 自定义中间件放置于此
        'yourapp.middleware.LoginRequiredMiddleware',
        'django.contrib.messages.middleware.MessageMiddleware',
        'django.middleware.clickjacking.XFrameOptionsMiddleware',
    ]
    
  • Django 3.0及以上版本可替换为新版无兼容层的中间件写法:
    class LoginRequiredMiddleware:
        def __init__(self, get_response):
            self.get_response = get_response
    
        def __call__(self, request):
            # 在此处编写和上述process_request一致的认证判断逻辑
            response = self.get_response(request)
            return response
    
  • 验证中间件生效时,可在逻辑开头打印request.path_info、request.user.is_authenticated的实际值,确认代码是否被触发、判断逻辑是否符合预期;切勿将整个受保护的路径前缀加入白名单,避免出现越权访问风险。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.06 08:15:04