Django登录表单is_valid()始终返回False且无错误提示

问题现象 #

• 调用form.is_valid()始终返回False，登录逻辑无法执行
• 即使在邮箱字段输入内容，form["email"].value()返回None
• HTML模板中无法显示任何表单错误信息

核心原因 #

1. 继承的表单字段冲突：自定义的BootstrapAuthenticationForm继承自AuthenticationForm，而AuthenticationForm默认依赖username字段完成认证，但你新增了email字段替代username，导致父类的认证逻辑找不到必需的username字段，直接验证失败。
2. 表单初始化方式错误：AuthenticationForm的初始化需要传入request对象作为第一个参数（用于处理认证上下文），仅传request.POST会导致部分逻辑失效。
3. 错误信息渲染不完整：模板中未正确渲染单个字段的错误，且多余的test字段会干扰表单渲染。

修复方案 #

方案1：修改父类username字段为邮箱样式（推荐） #

直接复用AuthenticationForm的username字段，修改其显示标签和样式，无需新增email字段，契合Django原生认证逻辑：

# forms.py
from django import forms
from django.contrib.auth.forms import AuthenticationForm

class BootstrapAuthenticationForm(AuthenticationForm):
    """使用Bootstrap样式的登录表单"""
    username = forms.CharField(
        max_length=254,
        label='邮箱',
        widget=forms.TextInput({
            'class': 'form-control',
            'placeholder': '邮箱'
        })
    )
    password = forms.CharField(
        label='密码',
        widget=forms.PasswordInput({
            'class': 'form-control',
            'placeholder': '密码'
        })
    )

方案2：保留email字段并适配认证逻辑 #

如果坚持使用email字段名，需在表单的clean方法中将email的值赋值给username，满足父类的认证要求：

# forms.py
from django import forms
from django.contrib.auth.forms import AuthenticationForm

class BootstrapAuthenticationForm(AuthenticationForm):
    """使用Bootstrap样式的登录表单"""
    email = forms.CharField(
        max_length=254,
        label='邮箱',
        widget=forms.TextInput({
            'class': 'form-control',
            'placeholder': '邮箱'
        })
    )
    password = forms.CharField(
        label='密码',
        widget=forms.PasswordInput({
            'class': 'form-control',
            'placeholder': '密码'
        })
    )

    def clean(self):
        # 将邮箱值传递给username字段，适配父类认证逻辑
        cleaned_data = super().clean()
        cleaned_data['username'] = cleaned_data.get('email')
        return cleaned_data

修正视图函数的表单初始化 #

确保AuthenticationForm初始化时传入request对象，并正确处理GET/POST请求：

# views.py
from django.shortcuts import render
from .forms import BootstrapAuthenticationForm

def postlogin(request):
    if request.method == 'POST':
        # 正确初始化AuthenticationForm：第一个参数为request，第二个为POST数据
        form = BootstrapAuthenticationForm(request, data=request.POST)
        # 先调用is_valid()触发完整验证流程，才能获取错误信息和字段值
        if form.is_valid():
            # 此处添加登录逻辑，例如：
            # from django.contrib.auth import login
            # login(request, form.get_user())
            return render(request, "app/home.html")
    else:
        # GET请求时创建空表单
        form = BootstrapAuthenticationForm(request)
    
    # 调试用：打印表单错误到控制台
    print(form.errors)
    return render(request, "app/login.html", {"form": form})

修复模板的错误渲染 #

删除多余的test字段，添加单个字段的错误提示，确保错误信息正常显示：

<!-- login.html -->
{% extends "app/layout.html" %}

{% block content %}
<h2>{{ title }}</h2>
<div class="row">
    <div class="col-md-8">
        <section id="loginForm">
            <form action="/postlogin/" method="post" class="form-horizontal">
                {% csrf_token %}
                <h4>使用本地账号登录</h4>
                <hr />
                
                <!-- 邮箱/用户名字段 -->
                <div class="form-group">
                    <label for="id_username" class="col-md-2 control-label">{{ form.username.label }}</label>
                    <div class="col-md-10">
                        {{ form.username }}
                        {% if form.username.errors %}
                            <span class="text-danger mt-1 d-block">{{ form.username.errors.0 }}</span>
                        {% endif %}
                    </div>
                </div>
                
                <!-- 密码字段 -->
                <div class="form-group">
                    <label for="id_password" class="col-md-2 control-label">{{ form.password.label }}</label>
                    <div class="col-md-10">
                        {{ form.password }}
                        {% if form.password.errors %}
                            <span class="text-danger mt-1 d-block">{{ form.password.errors.0 }}</span>
                        {% endif %}
                    </div>
                </div>
                
                <div class="form-group">
                    <div class="col-md-offset-2 col-md-10">
                        <input type="hidden" name="next" value="/" />
                        <input type="submit" value="登录" class="btn btn-default" />
                    </div>
                </div>

                <!-- 全局错误提示 -->
                {% if form.non_field_errors %}
                    <div class="col-md-offset-2 col-md-10 text-danger">
                        {{ form.non_field_errors.0 }}
                    </div>
                {% endif %}
            </form>
        </section>
    </div>
    <div class="col-md-4">
        <section id="socialLoginForm"></section>
    </div>
</div>
{% endblock %}

（如果使用方案2，模板中的form.username替换为form.email即可）

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