Django项目中authenticate()方法始终返回None如何排查解决？

核心故障原因 #

你自定义的User模型中is_active字段默认值设为了False，而Django默认使用的ModelBackend认证后端在校验用户凭证时，会自动过滤is_active = False的用户，直接返回None，和用户名密码是否正确无关。

修复方案 #

你可以根据业务需求二选一：

方案1：保留用户激活校验逻辑 #

如果你的业务要求用户完成激活（比如邮箱验证、审核通过）后才能登录，只需在用户激活流程中修改is_active字段为True即可。
如果是测试场景，可以直接手动修改测试用户的is_active状态：

from account.models import User
# 替换为你的测试用户名
user = User.objects.get(username='test_name')
user.is_active = True
user.save()

方案2：关闭活跃状态校验 #

如果你的业务不需要做用户激活限制，可以修改settings.py配置，更换认证后端为允许所有用户（包括非活跃用户）通过校验的版本：

# settings.py 中添加如下配置
AUTHENTICATION_BACKENDS = ['django.contrib.auth.backends.AllowAllUsersModelBackend']

其他校验项 #

如果修改后仍有问题，请确认你创建用户时使用的是User.objects.create_user()方法而非直接User.objects.create()，后者不会自动对密码做哈希处理，会导致凭证校验失败。
你可以在Django shell中执行如下测试代码快速定位问题：

from django.contrib.auth import authenticate
from account.models import User

# 先新建测试用户
test_user = User.objects.create_user(username='test001', password='testpass123')
test_user.is_active = True
test_user.save()

# 测试认证
auth_result = authenticate(username='test001', password='testpass123')
print(auth_result) # 正常会输出对应用户对象，否则再排查其他配置问题

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