Django UniqueConstraint验证未触发，抛出IntegrityError问题排查

我定义了如下DataMapping模型，配置了三个带条件的UniqueConstraint并设置了violation_error_message：

class DataMapping(models.Model):
    company = models.ForeignKey(Company, on_delete=models.CASCADE)
    location = models.ForeignKey(Location, null=True, blank=True, on_delete=models.CASCADE)
    department = models.ForeignKey(LocationDepartment, null=True, blank=True, on_delete=models.CASCADE)
    category = models.ForeignKey(CompanyCategory, on_delete=models.CASCADE)
    reason = models.ForeignKey(ReasonForProcessing, on_delete=models.CASCADE)

    class Meta:
        constraints = [
            UniqueConstraint(
                name='unique_data_map', 
                fields=['company', 'location', 'department', 'category', 'reason'],
                condition=Q(location__isnull=False),
                violation_error_message="This data map has already been added.",
            ),
            UniqueConstraint(
                name='unique_data_map_both_none_dep_none', 
                fields=['company', 'location', 'category', 'reason'],
                condition=Q(department__isnull=True),
                violation_error_message="This data map has already been added."
            ),
            UniqueConstraint(
                name='unique_data_map_both_none', 
                fields=['company', 'category', 'reason'],
                condition=Q(location__isnull=True) & Q(department__isnull=True),
                violation_error_message="This data map has already been added."
            )
        ]

搭配基础的ModelForm：

class DataMapForm(forms.ModelForm):
    class Meta:
        model = DataMapping
        fields = (
            'location',
            'department',
            'category',
            'reason',
        )
    widgets = {
        'company': forms.HiddenInput()
    }

以及视图：

def data_mapping_new(request):
    company = get_current_logged_in_company(request)

    if request.method == "POST":
        form = DataMapForm(request.POST or None)
        if form.is_valid():
            category = form.save(commit=False)
            category.company = company
            if form.is_valid():
                form.save()

我在另一个模型上用类似配置可正常工作，但当前模型会抛出错误django.db.utils.IntegrityError: duplicate key value violates unique constraint "unique_data_map_both_none"。按预期应该在第一个if form.is_valid()时就检查约束，请问我遗漏了什么？

补充：另一个模型的条件是针对字符字段condition=Q(email__isnull=False) & Q(email__gt='')，会不会是外键的条件设置有问题？

核心问题：表单验证时缺少company字段的值 #

模型的所有UniqueConstraint都包含company字段，但你初始化表单时没有把当前登录的company传递给表单，导致表单验证阶段无法完成模型层面的唯一约束检查——此时表单绑定的实例里company字段为空，只有在save(commit=False)后才赋值，约束检查只能在数据库层面触发，从而抛出IntegrityError。

具体修复步骤： #

1. 初始化表单时传入company初始值
   修改视图中表单的初始化代码，把company作为初始值传入，让表单在验证时就能拿到该字段的值：

   def data_mapping_new(request):
       company = get_current_logged_in_company(request)
   
       if request.method == "POST":
           # 传入initial参数绑定company初始值
           form = DataMapForm(request.POST, initial={'company': company})
           if form.is_valid():
               # 此时实例已包含company，无需手动赋值
               form.save()
               # 可添加重定向或成功提示逻辑
       else:
           form = DataMapForm(initial={'company': company})
       # 返回模板等后续逻辑
   

2. 确保表单包含company字段
   表单的Meta.fields里必须列出company，否则表单不会处理该字段，哪怕设置了HiddenInput也无效：

   class DataMapForm(forms.ModelForm):
       class Meta:
           model = DataMapping
           fields = (
               'company',  # 必须添加此字段
               'location',
               'department',
               'category',
               'reason',
           )
       widgets = {
           'company': forms.HiddenInput()
       }
   

3. 移除冗余的二次验证
   视图中save(commit=False)后再次调用form.is_valid()完全无效——表单的验证状态在第一次is_valid()时已确定，修改实例不会更新表单的验证结果，直接移除即可。

额外优化：约束条件的逻辑合理性 #

第二个约束unique_data_map_both_none_dep_none的条件仅设置Q(department__isnull=True)，会和第一个约束的location__isnull=False场景重叠，导致逻辑混乱。建议调整条件为：

UniqueConstraint(
    name='unique_data_map_dep_none', 
    fields=['company', 'location', 'category', 'reason'],
    # 明确location不为空且department为空
    condition=Q(location__isnull=False) & Q(department__isnull=True),
    violation_error_message="This data map has already been added."
)

调整后三个约束的条件完全互斥，覆盖所有场景：

• 场景1：location不为空、department非空 → 匹配第一个约束
• 场景2：location不为空、department为空 → 匹配调整后的第二个约束
• 场景3：location和department都为空 → 匹配第三个约束

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