Django内联表单验证忽略部分填写记录的问题求助

我明白你的痛点——部分填写的子表单被悄悄忽略，对于多字段的项目来说确实风险很高。咱们可以通过自定义表单验证和调整视图逻辑来解决这个问题，确保只要子表单有字段被填写，就必须补全所有必填项。

先看一下你的现有代码，然后给出具体修改方案：

现有代码 #

models.py #

from django.db import models
from django.utils import timezone
from django.urls import reverse

class Profile(models.Model):
    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
    created_date = models.DateTimeField(default=timezone.now)
    
    def get_absolute_url(self):
        return reverse('profile-update', kwargs={'pk': self.pk})
    
    def __unicode__(self):
        return "%s %s" % (self.first_name, self.last_name)

class FamilyMember(models.Model):
    profile = models.ForeignKey(Profile, on_delete=models.PROTECT)
    name = models.CharField(max_length=100)
    relationship = models.CharField(max_length=100)

forms.py #

from django.forms import ModelForm
from django.forms.models import inlineformset_factory
from .models import Profile, FamilyMember

class ProfileForm(ModelForm):
    class Meta:
        model = Profile
        exclude = ()

class FamilyMemberForm(ModelForm):
    class Meta:
        model = FamilyMember
        exclude = ()

FamilyMemberFormSet = inlineformset_factory(Profile, FamilyMember, form=FamilyMemberForm, extra=1)

views.py #

from django.views.generic.edit import CreateView
from django.urls import reverse_lazy
from django.db import transaction
from .models import Profile
from .forms import FamilyMemberFormSet

class ProfileCreate(CreateView):
    model = Profile
    fields = ['first_name', 'last_name']

class ProfileFamilyMemberCreate(CreateView):
    model = Profile
    fields = ['first_name', 'last_name']
    success_url = reverse_lazy('profile-list')
    
    def get_context_data(self, **kwargs):
        data = super(ProfileFamilyMemberCreate, self).get_context_data(**kwargs)
        if self.request.POST:
            data['familymembers'] = FamilyMemberFormSet(self.request.POST)
        else:
            data['familymembers'] = FamilyMemberFormSet()
        return data
    
    def form_valid(self, form):
        context = self.get_context_data()
        familymembers = context['familymembers']
        with transaction.atomic():
            self.object = form.save()
            if familymembers.is_valid():
                familymembers.instance = self.object
                familymembers.save()
        return super(ProfileFamilyMemberCreate, self).form_valid(form)

具体解决方案 #

1. 给子表单添加自定义验证逻辑 #

我们需要在FamilyMemberForm的clean方法里判断：如果表单有任意字段被填写，就必须确保所有必填字段都不为空。修改forms.py：

from django import forms  # 别忘了导入forms模块

class FamilyMemberForm(ModelForm):
    class Meta:
        model = FamilyMember
        exclude = ()
    
    def clean(self):
        cleaned_data = super().clean()
        # 收集所有非空的字段值，判断用户是否填写了这个表单
        filled_fields = [val for val in cleaned_data.values() if val not in [None, ""]]
        
        if filled_fields:
            # 定义你的必填字段列表，这里是name和relationship
            required_fields = ["name", "relationship"]
            missing = []
            for field in required_fields:
                if not cleaned_data.get(field):
                    missing.append(field)
            
            if missing:
                raise forms.ValidationError(f"请补全以下必填字段：{', '.join(missing)}")
        
        return cleaned_data

2. 调整视图的表单验证逻辑 #

原来的视图里，即使表单集无效，父表单保存后也会直接跳转，导致错误信息无法显示。我们要先验证表单集，只有当它有效时才保存：

修改views.py中的form_valid方法：

def form_valid(self, form):
    context = self.get_context_data()
    familymembers = context['familymembers']
    
    # 先检查表单集是否有效，无效的话返回表单页面显示错误
    if not familymembers.is_valid():
        return self.form_invalid(form)
    
    # 都有效再执行保存操作
    with transaction.atomic():
        self.object = form.save()
        familymembers.instance = self.object
        familymembers.save()
    
    return super().form_valid(form)

3. 模板中渲染错误信息 #

确保你的模板能显示表单集的错误，包括每个字段的错误和表单集的全局错误。示例模板代码片段：

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    
    <h3>亲属信息</h3>
    {{ familymembers.management_form }}
    {% for fm_form in familymembers %}
        {{ fm_form.id }}
        <div class="form-row">
            <div class="col">
                {{ fm_form.name.label_tag }}
                {{ fm_form.name }}
                {% if fm_form.name.errors %}
                    <small class="text-danger">{{ fm_form.name.errors.0 }}</small>
                {% endif %}
            </div>
            <div class="col">
                {{ fm_form.relationship.label_tag }}
                {{ fm_form.relationship }}
                {% if fm_form.relationship.errors %}
                    <small class="text-danger">{{ fm_form.relationship.errors.0 }}</small>
                {% endif %}
            </div>
        </div>
        <hr>
    {% endfor %}
    
    <!-- 显示表单集的全局错误 -->
    {% if familymembers.non_form_errors %}
        <div class="alert alert-danger">
            {{ familymembers.non_form_errors.0 }}
        </div>
    {% endif %}
    
    <button type="submit" class="btn btn-primary">保存</button>
</form>

可选优化：强制至少填写一个亲属记录 #

如果你希望用户必须添加至少一条亲属信息，可以在创建表单集时加上min_num和validate_min参数：

FamilyMemberFormSet = inlineformset_factory(
    Profile, 
    FamilyMember, 
    form=FamilyMemberForm, 
    extra=1,
    min_num=1,  # 至少需要1条有效记录
    validate_min=True  # 启用验证
)

这样修改后，只要用户填写了亲属表单的任何一个字段，系统就会强制要求补全所有必填项，不会再出现部分填写被忽略的情况。

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