使用Django自定义用户模型与AuthenticationForm登录报错求助

我之前踩过完全一样的坑！当你使用自定义User模型时，Django默认的AuthenticationForm并不会自动适配你的自定义模型——这就是为啥明明账号密码正确，却一直弹出"Please enter a correct username and password..."错误，而且authenticate始终返回None的核心原因。下面一步步帮你排查修复：

1. 必须自定义适配自定义User模型的AuthenticationForm #

默认的AuthenticationForm来自django.contrib.auth.forms，它硬编码依赖了Django原生的User模型。你需要在自己的app里创建一个自定义认证表单：

# 例如在你的inventory/forms.py中
from django.contrib.auth.forms import AuthenticationForm
from django.contrib.auth import get_user_model

# 动态获取配置的自定义User模型
User = get_user_model()

class CustomAuthenticationForm(AuthenticationForm):
    class Meta:
        model = User
        fields = ('username', 'password')

这里的关键是用get_user_model()替代直接导入django.contrib.auth.models.User，这样能确保表单使用你在settings.py中配置的AUTH_USER_MODEL对应的模型。

2. 在登录视图中替换为自定义表单 #

检查你的views.py，把原来使用默认AuthenticationForm的地方替换成上面的CustomAuthenticationForm，示例代码如下：

# inventory/views.py
from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect
from .forms import CustomAuthenticationForm

def login_view(request):
    if request.method == 'POST':
        # 注意这里要传递request作为第一个参数
        form = CustomAuthenticationForm(request, data=request.POST)
        if form.is_valid():
            username = form.cleaned_data.get('username')
            password = form.cleaned_data.get('password')
            user = authenticate(request, username=username, password=password)
            if user is not None:
                login(request, user)
                return redirect('your-dashboard-url')  # 替换成你的目标页面
    else:
        form = CustomAuthenticationForm()
    return render(request, 'login.html', {'form': form})

3. 排查其他常见诱因 #

• 密码哈希是否正确：创建用户时一定要用create_user()方法，而不是直接调用User.objects.create()——后者不会自动哈希密码，会导致认证失败。正确示例：

  user = User.objects.create_user(username='test_user', password='your_secure_password')
  

• 确认AUTH_USER_MODEL配置无误：虽然你已经设置了AUTH_USER_MODEL = 'inventory.User'，但要确保inventory app已经添加到INSTALLED_APPS中，且自定义User模型正确继承了AbstractUser或AbstractBaseUser（如果是后者，还要配置必要的认证后端）。
• 完成数据库迁移：修改自定义User模型或AUTH_USER_MODEL配置后，必须运行以下命令更新数据库：

  python manage.py makemigrations
  python manage.py migrate
  

• 注意大小写敏感性：错误提示提到了大小写敏感，确认你输入的用户名和创建时的大小写完全一致（比如创建的是AdminUser，输入adminuser会直接认证失败）。

4. 快速调试定位问题 #

如果还是无法解决，可以在视图中添加调试代码，精准定位问题所在：

# 在authenticate语句后添加
user = authenticate(request, username=username, password=password)
print(f"尝试认证的用户名: {username}")
print(f"该用户是否存在: {User.objects.filter(username=username).exists()}")
if User.objects.filter(username=username).exists():
    user_obj = User.objects.get(username=username)
    print(f"密码是否匹配: {user_obj.check_password(password)}")

通过这些打印信息，你能快速判断是用户不存在、密码不匹配，还是其他认证逻辑的问题。

内容的提问来源于stack exchange，提问作者Oh Great One