Django使用through中间模型删除时外键约束失败如何解决

1. 外键约束报错修复 #

你当前定义的ContactAddress模型中contact字段已经配置了on_delete=models.CASCADE，正常调用contact.delete()时Django会先自动删除所有关联的中间表记录，再删除Contact实例，不会触发该报错。出现该问题的核心原因大概率是数据库层面的外键约束规则和Django模型定义不一致，可按以下步骤排查修复：

• 先备份当前数据库所有数据，避免操作失误导致数据丢失
• 直接查询MySQL中contact_addresses表的外键约束，确认contact_id对应的外键删除规则是否为CASCADE，如果是RESTRICT或NO ACTION，手动修改约束规则为CASCADE即可
• 若确认数据库约束规则正确，检查删除逻辑执行前是否存在未提交的事务：如果之前创建了该Contact的关联中间表记录但未提交，Django层查询不到关联关系，但数据库实际存在记录，也会触发该报错

2. 自动删除仅绑定当前Contact的Address实现 #

推荐两种实现方案，可根据业务场景选择：

方案1：重写Contact的delete方法（适用单条删除为主的场景） #

直接在Contact模型中重写delete方法，逻辑全部封装在模型层，所有调用delete方法的场景都能自动生效：

from django.db import models, transaction

class Contact(AuditModel):
    contact_id = models.AutoField(primary_key=True)
    address = models.ManyToManyField('Address', through='ContactAddress')
    name_first = models.CharField(max_length=100)
    name_last = models.CharField(max_length=100)

    @transaction.atomic
    def delete(self, *args, **kwargs):
        # 筛选所有和当前Contact关联、且仅绑定了这一个Contact的Address
        solo_addresses = self.address.annotate(
            contact_cnt=models.Count('contactaddress__contact')
        ).filter(contact_cnt=1)
        
        # 先清空多对多关联（自动删除中间表记录）
        self.address.clear()
        # 删除孤本Address
        solo_addresses.delete()
        # 执行原有删除逻辑删除Contact本身
        super().delete(*args, **kwargs)

方案2：使用post_delete信号（兼容批量删除场景） #

如果业务中存在批量删除Contact的需求，Django的批量delete方法默认不会调用模型的delete方法，此时可以用信号实现：

from django.db import models, transaction
from django.db.models.signals import post_delete
from django.dispatch import receiver

@receiver(post_delete, sender=Contact)
def clean_solo_address_after_contact_delete(sender, instance, **kwargs):
    with transaction.atomic():
        # 筛选原关联、且当前没有关联任何其他Contact的孤本Address
        solo_addresses = Address.objects.filter(
            contactaddress__contact=instance
        ).annotate(
            contact_cnt=models.Count('contactaddress__contact')
        ).filter(contact_cnt=0)
        solo_addresses.delete()

注意：两种方案都加了事务控制，保证中间表删除、Address删除、Contact删除三个操作的原子性，避免出现数据不一致的问题。

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