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
相关产品推荐
相关产品推荐

