如何在Python的Django4.2中优雅实现软删除功能-Python教程-PHP中文网

软删除必须通过自定义Manager与QuerySet配对实现，因仅重写delete()方法无法拦截QuerySet批量删除；需统一处理模型字段、查询过滤、Admin后台及关联关系。

如何在python的django4.2中优雅实现软删除功能

软删除在 Django 4.2 中不能靠 delete() 方法直接实现——它默认是硬删，调用后数据彻底消失，连信号都发不出完整生命周期事件。必须从模型设计、查询拦截、管理后台适配三处同时动手，缺一不可。

给模型加 `is_deleted` 字段并重写 `delete()`

最常见错误是只加字段不改行为，导致 queryset.delete() 仍走硬删路径。Django 的 delete() 方法分两种调用方式：实例调用（obj.delete()）和批量调用（qs.delete()），二者逻辑不同，必须分别覆盖。

is_deleted 必须是 BooleanField(default=False)，不用 NullBooleanField——后者会让 filter(is_deleted=False) 漏掉 NULL 值，且无法被数据库索引高效利用
重写模型的 delete(self, using=None, keep_parents=False) 方法，仅对单实例生效；批量删除需靠自定义 QuerySet 和 Manager
务必调用 super().delete(...) 吗？不。软删时应跳过父类硬删逻辑，改用 self.save(update_fields=['is_deleted'])

示例：

class SoftDeletableQuerySet(models.QuerySet):
    def delete(self):
        return self.update(is_deleted=True)
<p>class SoftDeletableManager(models.Manager):
def get_queryset(self):
return SoftDeletableQuerySet(self.model, using=self._db).filter(is_deleted=False)</p><p>class Article(models.Model):
title = models.CharField(max_length=100)
is_deleted = models.BooleanField(default=False)</p><pre class="brush:php;toolbar:false;">objects = SoftDeletableManager()
all_objects = models.Manager()  # 保留访问全部记录的能力

def delete(self, using=None, keep_parents=False):
    self.is_deleted = True
    self.save(update_fields=['is_deleted'])

huaweicloud-python-sdk-helper

华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。

下载

避免 `RelatedManager` 绕过软删过滤

外键反向关系（如 author.article_set.all()）默认不走自定义 Manager，会查出已软删的数据。这是线上最容易踩的坑——前端显示“已删除文章”，用户还能点进去。

必须显式为 ForeignKey 设置 related_query_name，并配合 limit_choices_to 不够，关键在 related_name 后加 + 会禁用反向关系，但通常不现实
正确做法：在定义外键时，用 related_query_name='non_deleted'，再在反向查询时手动加过滤：author.article_set.filter(is_deleted=False)
更稳妥的是重写 RelatedManager 类，但 Django 4.2 不支持直接替换，推荐用封装方法代替，例如在 Author 模型里加 def active_articles(self): return self.article_set.filter(is_deleted=False)

Admin 后台需同步屏蔽软删项并开放恢复入口

Django Admin 默认对 is_deleted=True 的对象照常列出，且删除按钮点击后仍是硬删——这违背软删本意，也容易误操作。

在 ModelAdmin 中重写 get_queryset(self, request)，强制追加 .filter(is_deleted=False)
禁用默认删除动作：设置 actions = None，或自定义 action 调用 obj.delete()（触发软删逻辑）而非 queryset.delete()
恢复功能要单独做：添加一个 restore action，内部执行 queryset.update(is_deleted=False)，注意别调用 save() 触发信号循环
列表页加 is_deleted 字段并设 boolean=True，方便快速识别状态，但别允许按它排序（MySQL 对布尔字段排序效果差）