软删除必须通过自定义Manager与QuerySet配对实现，因仅重写delete()方法无法拦截QuerySet批量删除；需统一处理模型字段、查询过滤、Admin后台及关联关系。
软删除在 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 使用方法。
立即学习“Python免费学习笔记（深入）”；
避免 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() - 恢复功能要单独做：添加一个
restoreaction，内部执行queryset.update(is_deleted=False)，注意别调用save()触发信号循环 - 列表页加
is_deleted字段并设boolean=True，方便快速识别状态，但别允许按它排序（MySQL 对布尔字段排序效果差）
软删除真正的复杂点不在代码量，而在一致性：ORM 查询、admin、API 序列化、信号处理、数据库约束（比如唯一索引是否包含 is_deleted）、甚至迁移历史里的旧数据清洗——任何一处漏掉，都会让“软”变成“半软半硬”。
