Django报错：ContactForm无cleaned_data属性，form.is_valid()返回False

出现'ContactForm' object has no attribute 'cleaned_data'且form.is_valid()返回False的核心原因有两个：

• HTML表单的输入name属性与forms.py中定义的字段名不匹配，导致表单无法正确获取提交数据，直接验证失败。
• 即使表单验证通过，views.py中尝试从cleaned_data获取数据时使用了错误的键名。

注意：Django表单仅在form.is_valid()返回True时才会生成cleaned_data属性，验证失败时访问该属性会直接抛出上述错误。

1. 统一表单字段名与HTML输入的name属性 #

方案一：修改HTML模板的input name（推荐） #

将HTML中fname和lname的name属性改为与forms.py一致的first_name和last_name：

<div class="form-group mb-4">
    <label for="fname">First Name:</label><br>
    <input class="form-control" type="text" id="fname" name="first_name" required>
</div>
<div class="form-group mb-4">
    <label for="lname">Last Name:</label><br>
    <input class="form-control" type="text" name="last_name" id="lname" required>
</div>

方案二：修改forms.py的字段名（不推荐，会影响模型映射） #

如果不想修改HTML，可以调整forms.py的字段名，但后续入库时需要对应模型字段：

class ContactForm(forms.Form):
    fname = forms.CharField(max_length=80)
    lname = forms.CharField(max_length=80)
    email = forms.EmailField()
    date = forms.DateField()
    occupation = forms.CharField(max_length=80)

2. 修正views.py中的cleaned_data键名 #

确保从cleaned_data中取值的键与表单字段名严格一致：

from django.shortcuts import render
from .forms import ContactForm
from .models import Form

def index(request):
    if request.method == "POST":
        form = ContactForm(request.POST)
        if form.is_valid():
            # 键名与forms.py的字段名对应
            first_name = form.cleaned_data["first_name"]
            last_name = form.cleaned_data["last_name"]
            email = form.cleaned_data["email"]
            date = form.cleaned_data["date"]
            occupation = form.cleaned_data["occupation"]
            print(first_name)
            Form.objects.create(
                first_name=first_name, 
                last_name=last_name, 
                email=email,
                date=date, 
                occupation=occupation
            )
            return render(request, "index.html", {"form": form, "success": True})
    else:
        # GET请求初始化空表单
        form = ContactForm()
    # 验证失败或GET请求时，将表单传递给模板以显示错误
    return render(request, "index.html", {"form": form})

3. 在模板中显示表单错误（可选但重要） #

添加错误提示，让用户明确知道填写问题：

{% if form.errors %}
    <div class="alert alert-danger">
        {% for field in form %}
            {% for error in field.errors %}
                <p>{{ field.label }}: {{ error }}</p>
            {% endfor %}
        {% endfor %}
        {% for error in form.non_field_errors %}
            <p>{{ error }}</p>
        {% endfor %}
    </div>
{% endif %}

由于表单字段与模型Form的字段完全一致，使用ModelForm可大幅减少重复代码：

修改forms.py #

from django import forms
from .models import Form

class ContactForm(forms.ModelForm):
    class Meta:
        model = Form
        fields = ["first_name", "last_name", "email", "date", "occupation"]

简化views.py #

def index(request):
    if request.method == "POST":
        form = ContactForm(request.POST)
        if form.is_valid():
            # 直接保存到数据库，无需手动赋值
            form.save()
            return render(request, "index.html", {"form": form, "success": True})
    else:
        form = ContactForm()
    return render(request, "index.html", {"form": form})

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