Django模型通用软删除模式实现问题：级联功能失效

嘿，我之前在Django项目里实现通用软删除时，也踩过级联失效的坑，咱们来一步步解决这个问题：

你遇到的级联失效，本质是因为Django默认的on_delete级联规则是数据库层面的硬删除逻辑，而咱们的软删除是应用层面的标记操作——只修改is_deleted字段，并没有触发数据库的删除事件，所以默认级联不会生效。

下面是一套能兼顾软删除、级联逻辑和管理后台操作的通用实现：

1. 定义软删除抽象基类 #

先写一个抽象模型，封装软删除的核心逻辑，包括自定义管理器、软删除/恢复方法，还有手动处理关联对象的级联：

from django.db import models

class SoftDeleteManager(models.Manager):
    """默认管理器：只返回未删除的对象"""
    def get_queryset(self):
        return super().get_queryset().filter(is_deleted=False)

class SoftDeleteModel(models.Model):
    is_deleted = models.BooleanField(default=False, verbose_name="已删除")
    
    # 两个管理器：objects用于常规业务，all_objects用于后台全量操作
    objects = SoftDeleteManager()
    all_objects = models.Manager()

    def delete(self, using=None, keep_parents=False):
        """重写delete方法，执行软删除而非硬删除"""
        self.is_deleted = True
        self.save(update_fields=['is_deleted'])
        
        # 手动触发关联对象的级联软删除
        for rel in self._meta.related_objects:
            # 跳过多对多反向关联，避免循环处理
            if isinstance(rel, models.ManyToManyRel):
                continue
            # 获取关联模型和外键字段名
            related_model = rel.related_model
            foreign_key_field = rel.field.name
            # 批量更新关联对象的is_deleted状态
            related_model.all_objects.filter(**{foreign_key_field: self}).update(is_deleted=True)

    def restore(self):
        """恢复当前对象及关联对象（可根据需求关闭关联恢复）"""
        self.is_deleted = False
        self.save(update_fields=['is_deleted'])
        
        for rel in self._meta.related_objects:
            if isinstance(rel, models.ManyToManyRel):
                continue
            related_model = rel.related_model
            foreign_key_field = rel.field.name
            related_model.all_objects.filter(**{foreign_key_field: self}).update(is_deleted=False)

    class Meta:
        abstract = True

2. 配置管理后台 #

要让后台能查看、恢复、彻底删除已标记的对象，需要自定义Admin基类：

from django.contrib import admin
from django.contrib.admin.actions import delete_selected as original_delete_selected

def restore_selected(modeladmin, request, queryset):
    """批量恢复选中对象的动作"""
    queryset.update(is_deleted=False)
restore_selected.short_description = "恢复选中的对象"

def hard_delete_selected(modeladmin, request, queryset):
    """批量彻底删除（从数据库移除）的动作"""
    original_delete_selected(modeladmin, request, queryset)
hard_delete_selected.short_description = "彻底删除选中的对象（永久移除）"

class SoftDeleteAdmin(admin.ModelAdmin):
    """适配软删除的Admin基类"""
    # 后台显示所有对象（包括已删除的）
    def get_queryset(self, request):
        return self.model.all_objects.all()
    
    # 添加自定义动作
    actions = [restore_selected, hard_delete_selected, original_delete_selected]
    
    # 列表页显示删除状态，方便筛选
    list_display = ('__str__', 'is_deleted')
    list_filter = ('is_deleted',)

3. 业务模型使用示例 #

让你的业务模型继承SoftDeleteModel，Admin继承SoftDeleteAdmin即可：

# 示例模型
class Order(SoftDeleteModel):
    order_no = models.CharField(max_length=32)
    # 其他字段...

class OrderItem(SoftDeleteModel):
    order = models.ForeignKey(Order, on_delete=models.CASCADE)
    product_name = models.CharField(max_length=64)
    # 其他字段...

# 示例Admin
@admin.register(Order)
class OrderAdmin(SoftDeleteAdmin):
    list_display = ('order_no', 'is_deleted')

@admin.register(OrderItem)
class OrderItemAdmin(SoftDeleteAdmin):
    list_display = ('product_name', 'order', 'is_deleted')

• 数据库级联兼容：如果担心有人直接操作数据库硬删除父对象，可把on_delete改成models.PROTECT，强制只能通过应用层的软删除逻辑处理。
• 信号适配：重写delete方法后，Django原生的pre_delete/post_delete信号不会触发，若需要依赖信号逻辑，可自定义pre_soft_delete/post_soft_delete信号，在软删除方法里手动发送。
• 多对多关系：如果需要处理多对多的软删除，可给中间表也添加is_deleted字段，或者在软删除时过滤关联查询。
• 查询一致性：业务代码里务必使用objects管理器（而非all_objects），避免意外返回已删除对象。

内容的提问来源于stack exchange，提问作者Alien Life Form