Django切换联系人账单邮箱时触发UniqueConstraint引发IntegrityError问题

当你同时修改两个邮箱的is_billing_email状态时，Django默认会在同一个事务中依次保存这两个对象，但数据库的唯一约束是逐行即时检查的——不是等事务全部提交后再校验。也就是说：

• 若先保存新邮箱（将其is_billing_email设为True），此时数据库会同时存在两条is_billing_email=True的记录（原有账单邮箱还未被修改），直接触发唯一约束错误；
• 而你临时用的“先取消旧邮箱再设置新邮箱”的方式，因为中间不会出现双True的状态，所以能正常执行。

方法1：优化现有保存逻辑（不修改Model） #

在同一个原子事务中，先批量取消旧账单邮箱的状态，再设置新邮箱的状态，同时加锁防止并发冲突：

from django.db import transaction

def switch_billing_email(contact, new_email_obj):
    with transaction.atomic():
        # 锁定当前联系人的所有邮箱记录，避免并发修改导致的冲突
        Email.objects.select_for_update().filter(contact=contact)
        
        # 先批量取消原有账单邮箱
        Email.objects.filter(contact=contact, is_billing_email=True).update(is_billing_email=False)
        # 再设置新的账单邮箱
        Email.objects.filter(id=new_email_obj.id).update(is_billing_email=True)

用update()方法直接在数据库层面执行批量修改，不会产生中间状态的冲突，效率也比逐个save()更高。

方法2：重构Model设计（更优雅的根源解决方案） #

既然每个联系人只能有一个账单邮箱，不如直接在Contact模型中添加外键指向对应邮箱，替代布尔字段的设计，从根源避免约束冲突：

修改Contact模型 #

class Contact(models.Model):
    # 保留原有其他字段
    billing_email = models.ForeignKey(
        'Email',
        on_delete=models.SET_NULL,
        null=True,
        blank=True,
        related_name='as_billing_for'
    )

修改Email模型 #

移除is_billing_email字段和对应的UniqueConstraint：

class Email(models.Model):
    contact = models.ForeignKey(Contact, on_delete=models.CASCADE, related_name="contact_emails")
    email = models.EmailField(max_length=254, db_index=True, null=False, blank=False)
    is_contact_email = models.BooleanField(_("contact email"), default=True)
    is_subscribed_to_status_notifications = models.BooleanField(_("status notifications"), default=True)
    is_subscribed_to_newsletter = models.BooleanField(_("newsletter"), default=True)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                fields=["contact", "email"],
                name="contact_and_email_unqiue"
            )
        ]

这种设计的优势：

• 数据库外键天然保证一个联系人只能关联一个账单邮箱，无需额外约束；
• 切换账单邮箱只需更新Contact.billing_email字段，逻辑极简；
• 查询账单邮箱直接调用contact.billing_email，无需过滤布尔字段。

方法3：延迟约束检查（依赖数据库支持） #

如果必须保留原有布尔字段设计，可尝试设置延迟约束（仅PostgreSQL支持，MySQL不支持），让数据库在事务提交时再检查约束，而非逐行修改时检查：

models.UniqueConstraint(
    fields=["contact", "is_billing_email"],
    name="one_billing_email_per_contact",
    condition=models.Q(is_billing_email=True),
    deferrable=models.Deferrable.DEFERRED
)

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