Django前端注册用户登录时Authenticate返回None问题求助

这问题我之前帮朋友排查过几乎一模一样的情况，核心大概率是注册流程里密码没正确哈希存储，或者自定义用户模型的认证逻辑没配置到位。咱们一步步拆解排查：

1. 先查注册时的密码处理逻辑（最常见原因） #

Admin后台创建用户时，Django会自动对密码做哈希处理，但前端注册如果写得不对，很容易直接存明文密码——而authenticate函数是拿提交的密码和哈希后的密码比对的，自然返回None。

错误写法（别踩坑）： #

# 直接给password字段赋值明文，大错特错！
user = CustomUser(
    email=request.POST.get('email'),
    password=request.POST.get('password')
)
user.save()

正确写法二选一： #

要么用create_user方法（Django封装好的自动哈希逻辑）：

user = CustomUser.objects.create_user(
    email=request.POST.get('email'),
    password=request.POST.get('password')
    # 其他必填字段按需添加
)

要么先创建用户，再用set_password手动哈希：

user = CustomUser(email=request.POST.get('email'), ...)
user.set_password(request.POST.get('password'))  # 关键步骤！
user.save()

2. 确认自定义用户模型的核心配置 #

既然用邮箱作为登录标识，必须确保模型和配置都正确：

自定义用户模型里要指定登录字段： #

from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin

class CustomUser(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True, verbose_name='邮箱')
    # 其他字段：昵称、手机号等按需添加
    
    USERNAME_FIELD = 'email'  # 告诉Django用邮箱作为登录的唯一标识
    REQUIRED_FIELDS = []  # 注册时必填的其他字段，比如昵称就加进去
    
    # 别忘了添加必要的管理器
    objects = CustomUserManager()

配置文件里指定自定义用户模型： #

在settings.py里必须加上这行，否则Django还是用默认的User模型：

AUTH_USER_MODEL = '你的应用名.CustomUser'

3. 检查认证后端（可选，若自定义了认证逻辑） #

如果你写了自定义认证后端，要确保逻辑正确：

# 比如在应用下的backends.py里
from django.contrib.auth.backends import ModelBackend
from .models import CustomUser

class EmailBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            # 这里用邮箱匹配传入的username参数
            user = CustomUser.objects.get(email=username)
        except CustomUser.DoesNotExist:
            return None
        # 用Django自带的密码校验方法
        if user.check_password(password):
            return user

然后在settings.py里注册后端：

AUTHENTICATION_BACKENDS = [
    '你的应用名.backends.EmailBackend',
    'django.contrib.auth.backends.ModelBackend',  # 保留默认后端备用
]

4. 手动验证排查 #

如果上面的步骤都检查过了，还可以用Django Shell手动测试：

from django.contrib.auth import authenticate
from 你的应用名.models import CustomUser

# 先查前端注册的用户是否存在
user = CustomUser.objects.get(email='用户注册的邮箱')
# 验证密码是否正确
print(user.check_password('用户注册的密码'))  # 返回True才正常
# 再测试authenticate
auth_user = authenticate(email='用户注册的邮箱', password='用户注册的密码')
print(auth_user)  # 正常应该返回用户对象，而不是None

最后总结 #

90%的概率是注册时密码没哈希导致的，先从这点入手排查；剩下的情况基本都是自定义用户模型的配置没到位，或者登录视图里authenticate的参数传错了（比如把邮箱传给了错误的参数名）。

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