Django用户端会话超时重定向失效问题及优化方案咨询

一、修复现有视图层实现的问题 #

1. 统一会话检查逻辑（自定义装饰器） #

如果当前是在单个视图中零散处理会话检查，改用装饰器全局覆盖所有需要登录的用户端视图，避免遗漏：

from django.shortcuts import redirect
from django.contrib.auth import logout
from django.utils import timezone

def check_session_timeout(view_func):
    def wrapper(request, *args, **kwargs):
        if request.user.is_authenticated:
            last_activity = request.session.get('last_activity')
            if last_activity:
                # 按你的超时时间配置，示例为30分钟
                if timezone.now() - last_activity > timezone.timedelta(minutes=30):
                    logout(request)
                    # 携带当前页面作为跳转后返回的目标
                    return redirect(f'/login/?next={request.path}')
            # 更新会话最后活动时间
            request.session['last_activity'] = timezone.now()
        return view_func(request, *args, **kwargs)
    return wrapper

将该装饰器添加到所有用户端需要登录的视图上，或结合@login_required使用。

2. 修正会话配置（settings.py） #

确保会话相关配置正确，保证会话过期时间和更新逻辑生效：

# 会话超时时间（单位：秒，示例30分钟）
SESSION_COOKIE_AGE = 1800
# 关闭浏览器不自动过期会话
SESSION_EXPIRE_AT_BROWSER_CLOSE = False
# 每次请求都更新会话过期时间
SESSION_SAVE_EVERY_REQUEST = True
# 指定登录页面URL
LOGIN_URL = '/login/'

3. 检查中间件顺序 #

确保SessionMiddleware和AuthenticationMiddleware的顺序正确，自定义中间件（如果有）放在AuthenticationMiddleware之后：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    # 自定义会话中间件（如果使用）
    'your_app.middlewares.SessionTimeoutMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

二、全局统一实现方案（中间件方式） #

用自定义中间件可以同时覆盖Admin和用户端的会话超时逻辑，比视图层逐个处理更高效：

1. 编写会话超时中间件（your_app/middlewares.py） #

from django.shortcuts import redirect
from django.contrib.auth import logout
from django.utils import timezone
from django.conf import settings

class SessionTimeoutMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response
        # 从settings读取超时时间，默认30分钟
        self.timeout_seconds = getattr(settings, 'SESSION_TIMEOUT', 1800)

    def __call__(self, request):
        if request.user.is_authenticated:
            last_activity = request.session.get('last_activity')
            if last_activity:
                elapsed = timezone.now() - last_activity
                if elapsed.total_seconds() > self.timeout_seconds:
                    logout(request)
                    # 区分Admin和用户端的登录页，或统一使用LOGIN_URL
                    login_url = settings.LOGIN_URL if not request.path.startswith('/admin/') else '/admin/login/'
                    return redirect(f'{login_url}?next={request.path}')
            # 更新会话最后活动时间
            request.session['last_activity'] = timezone.now()

        response = self.get_response(request)
        return response

2. 在settings.py中注册该中间件 #

将上述中间件添加到MIDDLEWARE列表，位置在AuthenticationMiddleware之后。

三、实现登录后返回原页面 #

在登录视图中处理next参数，登录成功后重定向到用户之前访问的页面：

from django.contrib.auth import authenticate, login
from django.shortcuts import redirect, render

def user_login(request):
    if request.method == 'POST':
        username = request.POST['username']
        password = request.POST['password']
        user = authenticate(request, username=username, password=password)
        if user:
            login(request, user)
            # 获取跳转目标，默认回到首页
            next_url = request.GET.get('next', '/')
            return redirect(next_url)
        else:
            return render(request, 'login.html', {'error': '用户名或密码错误'})
    return render(request, 'login.html')

四、特殊场景处理 #

如果用户端存在AJAX请求，会话超时后返回的302重定向不会自动触发页面跳转，需要前端添加拦截逻辑：

// 示例jQuery AJAX拦截
$(document).ajaxComplete(function(event, xhr, settings) {
    if (xhr.status === 302) {
        window.location.href = xhr.getResponseHeader('Location');
    }
});

内容的提问来源于stack exchange，提问作者rahul jayaram