Django登录时authenticate返回None导致用户无法登录问题排查

你登录失败是以下几个问题叠加导致的：

• 逻辑判断写反：代码里if user is None分支执行登录跳转，else分支报密码错误，相当于认证失败才登录，认证成功反而报错，逻辑完全颠倒
• Django默认认证规则不匹配：原生authenticate()方法默认接收username作为登录账号字段，你传email参数无法完成校验，永远返回None
• 异常处理无中断：查询用户不存在的except块只打印日志，没有终止后续逻辑，代码会继续执行无效的认证流程
• 语法缩进错误：loginUser函数内的POST请求处理代码没有正确缩进，Python运行会直接抛语法错误
• 缺失GET请求处理：代码只处理了POST提交场景，用户访问登录页的GET请求没有返回渲染模板的逻辑
• 潜在密码加密问题：如果注册用户时没有用Django自带的create_user或set_password加密存储密码，明文密码永远无法通过认证校验
• 模型冗余隐患：自定义UserInfo模型重复存储了email、password、confirm_password等User模型已有的字段，容易出现数据不一致问题

1. 修正视图层代码 #

替换原有loginUser视图代码如下：

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

def loginUser(request):
    if request.method == 'POST':
        email = request.POST['email']
        password = request.POST['password']
        user = None
        try:
            # 先通过邮箱匹配到对应用户
            matched_user = User.objects.get(email=email)
            # 用Django默认要求的username参数做认证
            user = authenticate(request, username=matched_user.username, password=password)
        except User.DoesNotExist:
            pass

        # 修正判断逻辑：认证得到有效用户才执行登录
        if user is not None:
            login(request, user)
            return redirect('home')
        else:
            messages.error(request, "邮箱或密码错误")
    # 补充GET请求的登录页渲染逻辑，替换成你自己的模板路径
    return render(request, 'login.html')

2. 检查注册逻辑 #

确保创建用户时使用Django提供的加密方法存储密码，禁止直接存明文：

# 正确创建用户的方式，自动加密密码
User.objects.create_user(username=用户名, email=邮箱, password=明文密码)

如果你之前直接给user.password赋值明文，存量用户的密码全部无法通过认证，需要重置密码或者重新生成加密哈希值。

3. 清理冗余模型字段（建议） #

删除UserInfo模型里重复的email、password、confirm_password字段，这些字段Django自带的User模型已经内置，需要使用时直接通过外键关联调用即可，避免多存一份数据导致不一致。

如果想让authenticate()直接支持邮箱参数，不用每次先查用户，可以自定义认证后端：

1. 在对应app目录下新建backends.py文件：

from django.contrib.auth.models import User
from django.contrib.auth.backends import ModelBackend

class EmailAuthBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        login_email = kwargs.get('email') if kwargs.get('email') else username
        try:
            user = User.objects.get(email=login_email)
        except User.DoesNotExist:
            return None
        if user.check_password(password) and self.user_can_authenticate(user):
            return user

2. 在项目settings.py中添加配置：

AUTHENTICATION_BACKENDS = [
    '你的app名称.backends.EmailAuthBackend',
    'django.contrib.auth.backends.ModelBackend',
]

配置完成后，你就可以直接在视图里用authenticate(request, email=email, password=password)完成认证。

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