Django InlineFormSet删除已有实例时的unique_together验证异常

兄弟，我太懂你这个痛点了——Django自带的InlineFormSet在处理unique_together约束时，完全不会自动忽略标记为删除的表单。所以哪怕你把第一个已有数据库实例标了删除，校验阶段它还是会被算进重复检查里，导致第二个新表单触发non_field_errors。我之前踩过一模一样的坑，给你两个靠谱的解决方案：

方案一：自定义FormSet的clean方法，过滤已删除表单 #

直接重写FormSet的clean方法，在做联合唯一校验前，先把那些标记要删的表单踢出去。这样校验的时候只考虑要保留的表单，就不会被待删除的实例干扰了。

示例代码走一波：

from django.forms.models import BaseInlineFormSet
from django import forms

class CustomInlineFormSet(BaseInlineFormSet):
    def clean(self):
        # 先执行默认的clean逻辑，处理基础错误
        super().clean()
        
        # 过滤掉所有标记为删除的表单
        active_forms = [form for form in self.forms if not form.cleaned_data.get('DELETE', False)]
        
        # 收集所有保留表单的联合唯一字段组合
        seen_pairs = set()
        for form in active_forms:
            if not form.is_valid():
                # 如果表单本身已经有错误，跳过它避免干扰
                continue
            
            # 替换成你的unique_together字段，比如('category', 'name')
            unique_pair = (form.cleaned_data['category'], form.cleaned_data['name'])
            if unique_pair in seen_pairs:
                raise forms.ValidationError("该组合已存在，请修改")
            seen_pairs.add(unique_pair)

然后在创建InlineFormSet的时候指定这个自定义类：

from django.forms import inlineformset_factory
from .models import ParentModel, ChildModel

MyInlineFormSet = inlineformset_factory(
    ParentModel,
    ChildModel,
    formset=CustomInlineFormSet,
    # 其他参数比如fields、extra等按需配置
)

这个方案的好处是完全掌控校验逻辑，精准控制哪些表单参与联合唯一检查。

方案二：在子表单的clean方法中排除待删除实例 #

另一种思路是在子表单的clean方法里，查询数据库时额外排除FormSet中标记为删除的实例。不过要注意，待删除的实例此时还在数据库里，所以得从FormSet的上下文里拿要删除的PK列表。

示例代码：

from django import forms
from .models import ChildModel

class ChildModelForm(forms.ModelForm):
    class Meta:
        model = ChildModel
        fields = '__all__'
    
    def clean(self):
        cleaned_data = super().clean()
        field1 = cleaned_data.get('field1')
        field2 = cleaned_data.get('field2')
        
        if field1 and field2:
            # 基础查询：找相同的联合字段组合
            query = ChildModel.objects.filter(field1=field1, field2=field2)
            
            # 排除当前表单的实例（如果是编辑已有数据）
            if self.instance.pk:
                query = query.exclude(pk=self.instance.pk)
            
            # 排除FormSet中标记为删除的实例
            if hasattr(self, 'parent'):
                deleted_pks = [
                    form.instance.pk 
                    for form in self.parent.forms 
                    if form.cleaned_data.get('DELETE', False) and form.instance.pk
                ]
                query = query.exclude(pk__in=deleted_pks)
            
            if query.exists():
                raise forms.ValidationError("该组合已存在，请修改")
        
        return cleaned_data

然后把这个表单传给InlineFormSet：

MyInlineFormSet = inlineformset_factory(
    ParentModel,
    ChildModel,
    form=ChildModelForm,
    # 其他参数
)

这个方案更聚焦于单个表单的验证逻辑，适合需要在表单层面做更多自定义的场景。

为啥默认验证会出这问题？ #

说白了，Django的FormSet默认校验是在删除操作执行前跑的——也就是说，当你标记一个表单为删除时，这个操作要等整个FormSet验证通过后才会去数据库删数据。所以校验阶段，待删除的实例还“存在”，自然会被算进unique_together的检查里，导致新表单触发重复错误。

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