Django自定义用户模型登录表单认证失败问题求助

核心问题点 #

1. 表单冗余代码引发潜在异常
   CustomLoginForm中的clean_username_or_email方法完全无效：表单不存在username_or_email字段，该方法不会被Django自动调用，且方法内部逻辑存在未定义变量风险（若输入不含@，data变量未初始化），可能干扰表单验证流程。

2. 认证失败后的错误处理逻辑错误
   当authenticate返回None（普通用户认证失败）时，直接跳转到注册页面，未在登录页保留错误信息，用户无法知晓认证失败原因。

3. 普通用户密码未哈希（大概率根因）
   超级用户通过createsuperuser命令创建，密码会自动加密存储；但如果普通用户注册时未使用set_password()方法处理密码，直接将明文存入数据库，authenticate会因密码不匹配返回None，导致无法登录。

修复步骤 #

1. 修复登录表单（forms.py） #

删除无效的clean_username_or_email方法，若需验证邮箱是否存在，改为针对email字段的验证：

from django.contrib.auth import get_user_model
from django.core.validators import validate_email
from django.core.exceptions import ValidationError
from django import forms

class CustomLoginForm(forms.Form):
    email = forms.CharField(max_length=256, widget=forms.TextInput(
        attrs={'class': 'form-control', 'placeholder': 'Email'}))
    password = forms.CharField(widget=forms.PasswordInput(
        attrs={'class': 'form-control', 'placeholder': 'Password'}))

    # 可选：验证邮箱是否已注册
    def clean_email(self):
        email = self.cleaned_data.get('email')
        validate_email(email)
        if not get_user_model().objects.filter(email=email).exists():
            raise ValidationError("该邮箱未注册")
        return email

2. 修复登录视图逻辑（views.py） #

认证失败时停留在登录页面，展示错误信息，而非跳转注册：

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

def login_view(request):
    error = None
    if request.method == 'POST':
        form = CustomLoginForm(request.POST)
        if form.is_valid():
            user = authenticate(
                request, 
                username=form.cleaned_data['email'], 
                password=form.cleaned_data['password']
            )

            if user:
                login(request, user)
                return redirect('main:home')
            else:
                error = '邮箱或密码错误'
    else:
        form = CustomLoginForm()
    return render(request, 'account/login.html', {'form': form, 'error': error})

3. 确保用户注册时密码正确哈希 #

检查用户注册视图，确保创建用户时使用set_password()处理密码：

# 示例注册视图逻辑
from django.contrib.auth import get_user_model
from django.shortcuts import render, redirect

def register_view(request):
    if request.method == 'POST':
        email = request.POST.get('email')
        password = request.POST.get('password')
        # 收集其他字段数据
        first_name = request.POST.get('first_name')
        gender = request.POST.get('gender')
        year = request.POST.get('year')
        school_name = request.POST.get('school_name')

        # 创建用户并哈希密码
        user = get_user_model().objects.create(
            email=email,
            first_name=first_name,
            gender=gender,
            year=year,
            school_name=school_name
        )
        user.set_password(password)
        user.save()
        
        return redirect('accounts:login')
    return render(request, 'account/register.html')

4. 模板中显示错误信息（login.html） #

在表单上方添加错误展示区域：

{% if error %}
    <div class="alert alert-danger mb-3">{{ error }}</div>
{% endif %}

<form action="" name="form" method="post" onsubmit="return check()" class="p-3">
    {% csrf_token %}
    <img src="{% static 'accounts/img/logo1.png' %}" class="logo image1" width="350px" height="350px" alt=""><br>

    <div class="mb-3 image2">
        {{ form.email }}
    </div>

    <div class="mb-3">
        {{ form.password }}
    </div>

    <!-- 原表单其余内容 -->
</form>

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