Django中POST请求提交表单提示Invalid form的原因排查

问题情况 #

访问/login/路由渲染登录页面，提交表单至/login/process_loginform/路由处理时，视图函数始终输出Invalid form，表单验证失败。

错误原因分析 #

1. 表单字段名称不匹配 #

HTML表单输入框的name属性必须与LoginForm中定义的字段名完全一致：

• HTML里用户名输入框的name为username-name，但LoginForm的对应字段是username
• 密码输入框的name为password-name，但LoginForm的对应字段是password
  Django表单验证会通过字段名匹配POST提交的数据，名称不匹配时无法获取对应值，直接导致验证失败。

2. forms.py字段标签错误 #

LoginForm中password字段的label被错误设置为"username"，虽不直接引发验证失败，但属于明显逻辑错误，需修正。

修复代码 #

修正后的HTML表单 #

{% extends 'base.html' %}
{% block content %}
Hello
<form action="/login/process_loginform/" method="post">
        {% csrf_token %}
        <label for="username">Username</label>
        <input id="username-val" type="text" name="username" />
        <label for="password">Password</label>
        <input id="password-val" type="password" name="password" />
        <input type="submit" value="Login" />
</form>
{% endblock %}

核心修改：将输入框的name属性改为username和password，与LoginForm字段名完全一致。

修正后的forms.py #

from django import forms
class LoginForm(forms.Form):
    username = forms.CharField(label="username", max_length=64)
    password = forms.CharField(label="password", max_length=64)

核心修改：将password字段的label修正为"password"，匹配字段语义。

调试优化（可选） #

在视图函数中添加错误信息打印，便于后续调试：

def process_loginform(request):
    print(request.method)
    form = LoginForm(request.POST)
    if form.is_valid():
        print("Valid form")
    else:
        print("Invalid form")
        # 打印具体验证错误，快速定位问题
        print(form.errors)
    return HttpResponseRedirect("/login/welcome/")

验证效果 #

修改完成后重新提交表单，视图函数将输出Valid form，表单验证成功。

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