Django中带through模型的多对多关系软删除问题求助

解决方案1：全局修改关联查询逻辑（默认生效） #

重写Author模型中books关联的默认查询集，让每次调用author.books.all()时自动过滤中间表已软删除的记录：

from django.db import models

class Author(SoftDeleteModel):
    name = models.CharField(max_length=100)

    @property
    def books(self):
        # 过滤中间表BookAuthor未被软删除的关联记录
        return super().books.filter(bookauthor__is_deleted=False)

这种方式无需修改多对多字段定义，直接通过属性重写实现全局过滤，所有调用author.books的场景都会自动应用规则。

解决方案2：单次查询手动过滤（临时场景） #

如果仅需在特定查询中过滤软删除关联，可直接在查询时添加条件：

# 基础过滤方式
active_books = author.books.filter(bookauthor__is_deleted=False)

# 带预取优化的方式（避免N+1查询问题）
from django.db.models import Prefetch

active_books = author.books.prefetch_related(
    Prefetch(
        'bookauthor_set',
        queryset=BookAuthor.objects.filter(is_deleted=False),
        to_attr='active_book_authors'
    )
).filter(bookauthor__is_deleted=False)

解决方案3：自定义多对多管理器（彻底方案） #

通过自定义多对多关联管理器，让关联查询自动应用中间表的软删除过滤规则：

from django.db import models
from django.db.models.manager import Manager

class FilteredBookManager(Manager):
    def get_queryset(self):
        return super().get_queryset().filter(bookauthor__is_deleted=False)

class Book(SoftDeleteModel):
    title = models.CharField(max_length=200)
    authors = models.ManyToManyField(
        Author,
        through='BookAuthor',
        related_name='books',
        manager=FilteredBookManager()
    )

问题根源 #

django-soft-delete的软删除机制是通过模型默认管理器过滤is_deleted=False的记录，但Django默认的多对多关联查询不会自动应用中间表（BookAuthor）的管理器过滤规则，导致已软删除的关联记录仍会被包含在author.books.all()的结果中。我们需要手动添加中间表的过滤条件，或通过自定义管理器让过滤逻辑自动生效。

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