使用自定义AbstractUser模型后Django注册无法登录问题

1. 确认AUTH_USER_MODEL配置 #

首先检查项目settings.py中是否正确指定自定义用户模型，这是适配自定义用户的核心配置：

AUTH_USER_MODEL = '你的应用名.CustomUser'

如果未配置此项，Django会默认使用内置User模型，导致登录验证与你的CustomUser不匹配。

2. 替换默认登录表单 #

默认的AuthenticationForm基于内置User模型实现，无法适配自定义用户。需要创建自定义登录表单：

from django.contrib.auth.forms import AuthenticationForm
from django.contrib.auth import get_user_model

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

在登录视图中使用这个自定义表单：

• 类视图示例：

from django.contrib.auth.views import LoginView
from .forms import CustomAuthenticationForm

class CustomLoginView(LoginView):
    form_class = CustomAuthenticationForm
    template_name = '你的登录模板路径.html'

• 函数视图示例：

from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect
from .forms import CustomAuthenticationForm

def custom_login(request):
    if request.method == 'POST':
        form = CustomAuthenticationForm(request, data=request.POST)
        if form.is_valid():
            user = form.get_user()
            login(request, user)
            return redirect('首页路由名')
    else:
        form = CustomAuthenticationForm()
    return render(request, '你的登录模板路径.html', {'form': form})

3. 注册后手动完成用户登录 #

使用UserCreationForm创建用户后，需要主动调用login()函数完成登录，否则用户不会自动进入登录状态：

from django.contrib.auth import login
from django.shortcuts import render, redirect
from .forms import CustomUserCreationForm

def register(request):
    if request.method == 'POST':
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            user = form.save()
            # 手动登录创建好的用户
            login(request, user)
            return redirect('首页路由名')
    else:
        form = CustomUserCreationForm()
    return render(request, '注册模板路径.html', {'form': form})

同时确保你的注册表单也基于自定义用户模型：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = get_user_model()
        fields = ('username', 'email', 'password1', 'password2') # 根据你的需求调整字段

4. 排查认证后端与用户状态 #

如果以上步骤无效，检查：

• 是否自定义了认证后端，确保其逻辑兼容CustomUser
• 用户的is_active字段确实为1，无其他被限制登录的状态配置

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