Django自定义表单无法通过is_valid()校验问题求助

尝试不使用Django模板表单自定义AddressForm，但表单始终无法通过is_valid()校验。即使POST请求包含对应字段数据，访问form.cleaned_data也会报错，无法正常访问表单字段。

相关代码 #

forms.py #

class AddressForm(forms.Form):
    address_long = forms.CharField(max_length=500)

    class Meta:
        model = Address
        fields = ['address_long']

    def save(self, commit=True):
        address = Address.objects.create()
        address.address_long = self.cleaned_data['address_long']
        
        if commit:
            address.save()

        return address

views.py #

@login_required
def add_address_view(request):
    if request.method == 'POST':
        form = AddressForm(request.POST)
        print(request.POST)
        if form.is_valid():
            print("Valid")
            address = form.save()
            user_profile = request.user.userprofile
            user_profile.addresses.add(address) # Add to many to many field
            user_profile.save() 

            return redirect('core:profile')  # Redirect to the user's profile page
    else:
        form = AddressForm()

    return render(request, 'Test_site/add-address.html', {'form': form, 'countries': COUNTRIES})

HTML代码 #

...
<form method="POST" class="col-md-5 border-right">
   {% csrf_token %}
   ...
   <div class="col-md-12">
      <label class="labels">Address Long</label>
      <input name="{{ form.address_long.name }}" id="{{ form.address_long.auto_id }}"  type="text" class="input-field form-control" placeholder="enter address line" value="">
   </div>
   ...   
</form>

POST请求输出 #

<QueryDict: {'csrfmiddlewaretoken': ['my_generated_token'], 'address_long': ['Long address try']}>

注：AddressForm包含其他CharField字段，提交时所有字段均已填写完整。

问题原因及解决方法 #

核心问题：错误混用forms.Form和ModelForm写法 #

你的AddressForm继承自forms.Form（普通表单），但又添加了Meta类指定model和fields——这是ModelForm的专属配置，普通表单不支持该逻辑，会导致表单校验机制混乱，进而无法通过is_valid()。

两种修正方案 #

方案1：改用ModelForm（推荐，更简洁）

如果表单用于操作Address模型，直接继承ModelForm，无需自定义save方法（ModelForm自带完善的模型交互逻辑）：

from django import forms
from .models import Address

class AddressForm(forms.ModelForm):
    class Meta:
        model = Address
        fields = ['address_long']  # 可添加其他需要的模型字段

此方式会自动关联模型字段，校验逻辑正常，save方法可直接使用。

方案2：保持forms.Form，移除Meta类

若坚持使用普通表单，需删除Meta类，并确保所有表单字段都在类中明确定义：

class AddressForm(forms.Form):
    address_long = forms.CharField(max_length=500)
    # 必须添加你提到的其他CharField字段，与POST请求中的字段名对应

    def save(self, commit=True):
        address = Address.objects.create(
            address_long=self.cleaned_data['address_long']
            # 其他字段需从cleaned_data中取值并赋值
        )
        if commit:
            address.save()
        return address

额外检查点 #

• 确保HTML中所有表单字段的name属性，与表单类中定义的字段名完全一致，避免拼写错误
• 若表单包含其他字段，必须在表单类中全部声明，否则未声明字段会被校验逻辑忽略，若对应模型字段为必填项，会导致保存失败

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