Django模型clean方法如何排除inline_formset已删除对象避免校验误报

原有模型层的clean方法只能读取数据库持久化的数据，无法感知当前inline formset提交批次里的临时状态：包括标记为删除的待移除记录、还没写入数据库的修改/新增记录，所以会出现误判。
这种跨多对象的批量校验场景，不适合放在单模型的clean方法中，最佳实践是重写inline formset的clean方法做全局校验，在该方法中你可以拿到当前批次所有表单的完整状态。

步骤1：自定义FormSet类 #

from django.forms import ValidationError
# 普通外键inline用下方导入
from django.forms.models import BaseInlineFormSet
# 如果是泛型外键inline，替换为下方导入
# from django.contrib.contenttypes.forms import BaseGenericInlineFormSet

class MyModelInlineFormSet(BaseInlineFormSet):
    def clean(self):
        # 先执行父类默认校验，避免基础错误干扰
        super().clean()
        if any(self.errors):
            return
        
        # 收集两类数据：待保留的实例、待删除的实例ID
        kept_ranges = []
        delete_ids = []
        
        for form in self.forms:
            # 跳过标记为删除的表单，记录待删除ID
            if self.can_delete and form.cleaned_data.get('DELETE'):
                if form.instance.pk:
                    delete_ids.append(form.instance.pk)
                continue
            # 跳过空表单
            if not form.cleaned_data:
                continue
            
            current_range = form.cleaned_data.get('date_range')
            current_id = form.instance.pk
            
            # 校验同批次待保留的记录之间是否重叠
            for kept_id, kept_range in kept_ranges:
                if current_range.overlap(kept_range):
                    raise ValidationError("同批次提交的时间段存在重叠，请调整后再提交")
            kept_ranges.append((current_id, current_range))
        
        # 校验待保留的记录和数据库中除待删除之外的记录是否重叠
        for obj_id, date_range in kept_ranges:
            queryset = self.model.objects.filter(date_range__overlap=date_range)
            # 排除自身（更新已有记录的场景）
            if obj_id:
                queryset = queryset.exclude(id=obj_id)
            # 排除本次待删除的记录
            if delete_ids:
                queryset = queryset.exclude(id__in=delete_ids)
            
            if queryset.exists():
                raise ValidationError(f"时间段 {date_range} 与现有记录重叠，请调整后再提交")

步骤2：绑定自定义FormSet #

如果在Django Admin中使用inline，修改你的Inline配置即可：

from django.contrib import admin
from .models import MyModel, ParentModel

class MyModelInline(admin.TabularInline):
    model = MyModel
    formset = MyModelInlineFormSet # 绑定自定义formset
    extra = 0

@admin.register(ParentModel)
class ParentModelAdmin(admin.ModelAdmin):
    inlines = [MyModelInline]

如果是自定义页面手动使用formset，实例化时传入formset=MyModelInlineFormSet参数即可。

该方案同时修复了原有逻辑的两个漏洞：

• 不再将本次待删除的记录判定为冲突源
• 可检测同批次提交的多条新增/修改记录之间的重叠问题

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