Django自定义邮箱登录时login返回None、登录异常问题排查

核心问题定位 #

• 对login函数的返回值存在误解。Django内置的login方法本身没有任何返回值，执行逻辑仅负责将用户ID、对应认证后端的标识写入当前请求的会话（Session），打印结果为None属于完全正常的现象，不代表登录逻辑执行失败。你控制台日志中的302跳转、home页面正常加载的结果，已经说明登录写Session的流程被触发了。
• 调用login时传入的backend参数配置错误。你当前手动指定后端为django.contrib.auth.backends.ModelBackend，但实际拿到的用户对象是通过自定义EmailBackend校验得到的，二者不匹配会导致后续会话校验时无法正确识别用户身份，出现“登录成功但访问受保护页面仍被重定向到登录页”的隐性问题。
• 自定义EmailBackend类的写法不符合Django认证系统的规范。
  • 实例方法遗漏了self作为第一个参数，你当前定义的def authenticate(username=None,password=None)没有self参数，Django的认证系统根本无法正常实例化、调用这个后端。
  • 认证失败时主动抛出ValidationError的逻辑不符合规范：Django认证流程要求authenticate方法校验失败时返回None，主动抛异常会触发全局错误拦截。
• 视图层完全绕开了Django原生认证链路，手动导入后端类直接调用方法，会导致后续的认证状态校验、权限判断逻辑失效。

分步修复实现 #

1. 修正backends.py代码，符合Django认证后端规范
   调整后的完整代码：

   from django.contrib.auth import get_user_model
   
   UserModel = get_user_model()
   
   class EmailBackend:
       # 实例方法必须包含self参数，同时兼容Django标准的request传参
       def authenticate(self, request, username=None, password=None, **kwargs):
           try:
               # 匹配对应邮箱的用户
               user = UserModel.objects.get(email=username)
               # 校验密码与用户激活状态
               if user.check_password(password) and user.is_active:
                   return user
               return None
           except UserModel.DoesNotExist:
               return None
   
       def get_user(self, user_id):
           try:
               return UserModel.objects.get(pk=user_id)
           except UserModel.DoesNotExist:
               return None
   

2. 修正视图层登录逻辑，对接Django原生认证入口
   不要手动导入自定义Backend类直接调用方法，直接使用Django提供的authenticate函数，它会自动遍历你在settings中配置的所有认证后端完成校验，拿到的用户对象会自动绑定对应所属后端的路径，调用login时完全不需要手动传backend参数。
   调整后的登录视图代码：

   from django.shortcuts import render, redirect
   from django.contrib.auth import authenticate, login
   from users.forms import LoginForm, RegisterForm
   
   def user_login(request):
       if request.method == 'POST':
           # 自动遍历所有配置的认证后端完成校验
           user = authenticate(
               request=request,
               username=request.POST['username'],
               password=request.POST['password']
           )
           if user is not None:
               login(request, user)
               # 登录成功后跳转至目标页面
               return redirect('home')
       else:
           form = LoginForm()
       return render(request, 'users/login.html', {'form': form})
   

3. 补全自定义用户模型的缺失配置
   • 确认settings.py中已添加AUTH_USER_MODEL = 'users.CustomUser'，指定你自定义的用户模型为项目默认用户模型。
   • 在models.py中为CustomUser关联继承自BaseUserManager的用户管理器，添加objects = UserManager()配置，否则用户模型的数据库操作会出现异常。
4. 验证登录状态是否生效
   登录完成后，可在后续的受保护视图中通过request.user.is_authenticated判断登录状态，不要通过login函数的返回值判断执行结果。

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