Django自定义User模型无法正常认证问题求助

可能的原因及对应解决步骤 #

1. 自定义User模型字段无默认值，导致用户数据异常 #

你的bio和role字段未设置blank=True或默认值，创建用户时必须填写这两个字段。若手动创建用户时未填写，或迁移时自动生成的默认值不符合要求，会导致用户数据不完整，影响认证。

修改User模型：

from django.contrib.auth.models import AbstractUser
from django.db import models

class User(AbstractUser):
    bio = models.TextField(blank=True)  # 允许为空
    role = models.CharField(max_length=32, blank=True)  # 允许为空

重新执行迁移：

python manage.py makemigrations
python manage.py migrate

2. 用户密码未正确哈希存储 #

如果创建用户时直接赋值password字段（比如user.password = "123456"），密码会以明文存储，而authenticate方法只识别哈希后的密码。

正确创建用户的方式（以shell为例）：

from landingpage.models import User
user = User.objects.create(username="testuser", bio="test bio", role="student")
user.set_password("123456")  # 哈希密码
user.save()

3. 用户is_active字段为False #

如果用户的is_active属性是False，authenticate会直接返回None。可在shell中检查：

user = User.objects.get(username="testuser")
print(user.is_active)

若为False，执行user.is_active = True并user.save()。

4. 中途修改AUTH_USER_MODEL导致迁移异常 #

Django要求必须在项目初始化时就设置AUTH_USER_MODEL，若项目已创建默认auth_user表后才改为自定义User模型，会导致数据库表结构混乱，认证时无法正确匹配用户数据。

解决方法（开发环境适用，数据需提前备份）：

• 清空数据库
• 删除所有app下的迁移文件（保留__init__.py）
• 重新执行初始化迁移：

python manage.py makemigrations
python manage.py migrate

• 重新创建测试用户。

5. 未正确导入authenticate方法 #

确保登录视图中正确导入：

from django.contrib.auth import authenticate
from django.http import HttpResponseRedirect

6. 检查认证后端配置 #

默认情况下Django使用ModelBackend，若settings.py中修改了AUTHENTICATION_BACKENDS，可能导致认证失败。确认settings.py中：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
]

调试建议 #

在登录视图中添加调试代码，定位具体问题：

def login(request):
    if request.method=='GET':
        return HttpResponseRedirect('/')
    username=request.POST['username']
    password=request.POST['password']
    user = authenticate(username=username, password=password)
    # 调试信息
    if not user:
        try:
            user_obj = User.objects.get(username=username)
            print("用户存在，但密码不匹配")
            print("存储的密码哈希:", user_obj.password)
            print("is_active状态:", user_obj.is_active)
        except User.DoesNotExist:
            print("用户不存在")
    return HttpResponseRedirect('/')

运行项目后查看控制台输出，明确问题所在。

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