Django REST Framework：实现关联模型的级联激活/禁用功能

1. 定义统一基类模型 #

先创建一个抽象基类，让所有需要级联状态管理的模型继承它，统一维护is_active字段：

from django.db import models

class ActiveStatusModel(models.Model):
    is_active = models.BooleanField(default=True)

    class Meta:
        abstract = True

之后你的业务模型直接继承这个基类即可：

class Company(ActiveStatusModel):
    name = models.CharField(max_length=100)
    # 其他业务字段...

class Branch(ActiveStatusModel):
    company = models.ForeignKey(Company, on_delete=models.CASCADE, related_name='branches')
    name = models.CharField(max_length=100)
    # 其他业务字段...

class Department(ActiveStatusModel):
    branch = models.ForeignKey(Branch, on_delete=models.CASCADE, related_name='departments')
    name = models.CharField(max_length=100)
    # 其他业务字段...

class Employee(ActiveStatusModel):
    department = models.ForeignKey(Department, on_delete=models.CASCADE, related_name='employees')
    name = models.CharField(max_length=100)
    # 其他业务字段...

2. 编写信号接收器实现动态级联 #

利用Django的post_save信号，监听基类模型的状态变更，自动遍历所有关联的子模型并同步状态，逻辑完全动态无需手动维护关联关系：

from django.db.models.signals import post_save
from django.dispatch import receiver
from django.db.models import ForeignKey
from django.db import transaction

@receiver(post_save, sender=ActiveStatusModel, dispatch_uid='cascade_active_status')
@transaction.atomic
def cascade_active_status(sender, instance, created, update_fields, **kwargs):
    # 仅在is_active字段变更时执行逻辑
    if not created and (update_fields is None or 'is_active' in update_fields):
        target_status = instance.is_active
        
        # 遍历当前实例的所有反向外键关联
        for related_object in instance._meta.related_objects:
            if isinstance(related_object.field, ForeignKey):
                related_model = related_object.related_model
                # 确保关联模型也继承了状态基类
                if issubclass(related_model, ActiveStatusModel):
                    # 获取反向关联的所有子实例，批量更新状态（仅更新不一致的记录）
                    related_queryset = getattr(instance, related_object.name).all()
                    updated_count = related_queryset.filter(is_active__ne=target_status).update(is_active=target_status)
                    
                    # 递归处理子实例的关联对象，实现多层级级联
                    if updated_count > 0:
                        for child_instance in related_queryset:
                            cascade_active_status(related_model, child_instance, created=False, update_fields={'is_active'}, **kwargs)

3. 核心逻辑说明 #

• 动态关联检测：通过instance._meta.related_objects自动获取所有指向当前实例的外键关联，新扩展的模型只要继承ActiveStatusModel并设置外键，就会自动纳入级联逻辑，无需手动修改代码。
• 递归级联：更新子实例状态后，递归触发信号逻辑，确保所有层级的关联对象（如Company→Branch→Department→Employee）都同步状态。
• 性能优化：用filter(is_active__ne=target_status)过滤需要更新的实例，结合批量update减少数据库操作；加上@transaction.atomic保证级联操作的原子性，避免部分更新失败导致数据不一致。
• 灵活扩展：如果某些模型不需要级联处理，可以在信号中添加排除规则，比如判断模型名称或自定义元数据标记。

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