Django自定义AuthenticationForm验证失败问题排查

问题描述 #

输入正确的用户名和密码后，自定义的AuthenticationForm始终验证失败，控制台已输出POST数据但提示form invalid。相关代码如下：

forms.py #

class CustomAuthForm(AuthenticationForm):
    username = forms.CharField(required=True, max_length = 50,
 widget=forms.EmailInput(attrs={"placeholder": "Email", "class":"form-control"}))

    password = forms.CharField(required=True, max_length = 50,
 widget=forms.PasswordInput(attrs={"placeholder":"Password", "class":"form-control"}))

views.py #

@csrf_protect
def user_login(request):
    if request.user.is_authenticated:
        return redirect('/')

    form=CustomAuthForm(request.POST or None)
    print(request.POST)
    if form.is_valid():
        print(form.cleaned_data)
    else:
        print ('form invalid')

控制台输出 #

<QueryDict: {'csrfmiddlewaretoken': ['mt5a3e9KyCbVg4OokaDeCu97EDrHVInAwVJmmK3a2xn0Nn4KRi0gt7axWJyRDMmT'], 
'username': ['myemail@gmail.com'], 'password': ['mypass']}>

form invalid

排查与解决 #

1. 未传递request对象给表单 #

Django的AuthenticationForm初始化必须接收request作为第一个参数，它的认证逻辑依赖该对象完成用户校验。当前代码只传入了POST数据，缺失request参数导致验证流程中断。

修改views.py的表单初始化代码：

form = CustomAuthForm(request, request.POST or None)

2. 自定义字段覆盖内置验证逻辑 #

直接重新定义username和password字段会丢失AuthenticationForm自带的用户认证验证（比如检查用户存在性、密码匹配），仅保留了基础的字段格式验证，无法完成实际的登录校验。

若仅需修改字段的显示样式，建议在__init__方法中修改widget属性：

class CustomAuthForm(AuthenticationForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields['username'].widget = forms.EmailInput(attrs={"placeholder": "Email", "class":"form-control"})
        self.fields['password'].widget = forms.PasswordInput(attrs={"placeholder":"Password", "class":"form-control"})

3. 打印表单错误详情定位问题 #

在验证失败分支中打印表单错误信息，可精准找到具体失败原因：

else:
    print(form.errors)  # 输出具体错误内容

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