Django自定义用户模型认证失败：authenticate始终返回None

1. 确认AUTH_USER_MODEL配置 #

首先检查settings.py里是否正确指定了自定义用户模型：

AUTH_USER_MODEL = 'your_app.CustomUser'

未设置该配置时，Django会默认使用自带的User模型，导致authenticate无法匹配到你的CustomUser实例。

2. 使用正确的authenticate参数 #

由于你将USERNAME_FIELD设为email，调用authenticate时必须传入email参数，而非默认的username：

# 正确写法
user = authenticate(request, email=解密后的邮箱, password=解密后的密码)

# 错误写法（会直接匹配失败）
user = authenticate(request, username=你的邮箱, password=你的密码)

Django的authenticate方法会依据USERNAME_FIELD的设置，查找对应字段的用户，参数名必须与USERNAME_FIELD的值完全一致。

3. 检查用户的is_active状态 #

authenticate仅会返回is_active=True的用户，需确保你的用户实例满足该条件：

• 在自定义UserManager的create_user方法中，显式设置is_active=True：

class CustomUserManager(BaseUserManager):
    def create_user(self, email, password=None, **extra_fields):
        if not email:
            raise ValueError('必须设置邮箱字段')
        email = self.normalize_email(email)
        user = self.model(email=email, **extra_fields)
        user.set_password(password)
        user.is_active = True  # 显式激活用户
        user.save(using=self._db)
        return user

• 直接查看数据库，确认is_active字段值为1（布尔字段存储时的对应值）。

4. 验证自定义User模型的必要实现 #

确保CustomUser模型正确继承并实现了核心属性与方法：

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

class CustomUser(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True)
    is_active = models.BooleanField(default=True)
    is_staff = models.BooleanField(default=False)

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []  # 按需添加必填字段

    objects = CustomUserManager()

    def get_full_name(self):
        return self.email

    def get_short_name(self):
        return self.email

缺少PermissionsMixin或必要方法可能导致认证逻辑异常。

5. 确认密码解密后的完整性 #

即便你认为解密正常，仍需验证解密后的密码与创建用户时的明文完全一致：

• 在调用authenticate前，打印解密后的密码，对比是否存在空格、换行符、编码错误（如多余的字节前缀b'）。
• 用硬编码的明文密码临时测试，排除解密环节的问题：

# 硬编码测试示例
user = authenticate(request, email='test@example.com', password='你的明文密码')

如果硬编码测试成功，说明解密过程存在字符串处理问题，需检查RSA解密后的结果格式。

6. 检查认证后端配置 #

若自定义了认证后端，需确保其authenticate方法正确适配CustomUser模型：

• 默认的ModelBackend支持自定义User模型，若替换为自定义后端，需保证逻辑正确：

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

class CustomAuthBackend(ModelBackend):
    def authenticate(self, request, email=None, password=None, **kwargs):
        try:
            user = CustomUser.objects.get(email=email)
            if user.check_password(password) and user.is_active:
                return user
        except CustomUser.DoesNotExist:
            return None

未自定义后端时，确认settings.py的AUTHENTICATION_BACKENDS包含默认的django.contrib.auth.backends.ModelBackend。

7. 验证数据库中的密码哈希 #

确认数据库中存储的密码为正确的哈希值：

• 调用user.check_password(明文密码)验证，若返回True说明哈希正常，此时认证失败大概率是前面步骤存在遗漏。

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