Django登录authenticate返回None求助：自定义数据库验证失败

1. authenticate调用参数不全 #

Django 默认的authenticate()必须同时传入username和password才能完成认证，你只传了username，这是返回None的核心原因之一。正确调用示例：

user = authenticate(request, username=username, password=password)

2. 错误判断类属性User.is_active #

你现在判断的是User类的is_active属性，不是具体用户实例的属性——类属性默认是True，但这和实际用户的状态无关。必须先拿到认证后的用户实例，再判断实例的is_active：

if user is not None:
    if user.is_active:
        # 执行登录流程
    else:
        # 用户账号被禁用
else:
    # 账号或密码错误

3. 未用create_user()导致密码存储不规范 #

Django 的User模型要求密码以特定哈希格式存储，直接手动创建用户而不调用create_user()，会导致密码是明文或无效哈希。authenticate()只会验证合法哈希后的密码，自然返回None。

修复方法：

• 注册用户时必须用User.objects.create_user(username, email, password)，该方法自动处理密码哈希。
• 存量用户需批量转换密码格式，用make_password()：

from django.contrib.auth.hashers import make_password

# 示例：更新单个用户的密码哈希
user = User.objects.get(username="your_username")
user.password = make_password("原明文密码")
user.save()

4. 自定义数据库操作绕开Django认证机制 #

你直接用sqlite3连接数据库校验密码的方式，和Django自带的认证流程冲突。如果要自定义认证逻辑，应该写自定义认证后端，而非直接操作数据库：

1. 在你的app下新建backends.py：

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

class CustomAuthBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            user = User.objects.get(username=username)
            # 这里可以加入你的自定义密码校验逻辑
            # 优先用Django自带的check_password验证哈希密码
            if user.check_password(password):
                return user
        except User.DoesNotExist:
            return None

    def get_user(self, user_id):
        try:
            return User.objects.get(pk=user_id)
        except User.DoesNotExist:
            return None

2. 在settings.py中配置这个后端：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'your_app_name.backends.CustomAuthBackend',  # 替换为你的app路径
]

调试小技巧 #

• 打印authenticate传入的username和password，确认和数据库存储的一致。
• 查看auth_user表的password字段，确认是pbkdf2_sha256$开头的哈希值，不是明文。
• 直接通过User.objects.get(username=xxx)拿到用户实例，调用user.check_password(输入的密码)，看是否返回True，快速定位密码验证环节的问题。

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