Django反向关联查询时如何过滤返回的关联子项数据

你遇到的问题是Django ORM的跨关联过滤的默认特性导致的：外层filter(books__published_at__range=xxx)仅用来筛选「至少有一本图书符合日期范围的作者」，并不会作用到后续获取关联books集合的查询上，默认会返回该作者的所有关联图书。

以下是两种常用的实现方案：

方案1：使用Prefetch自定义关联查询（推荐，性能最优） #

这是Django ORM原生支持的方案，通过Prefetch对象提前指定关联books的过滤条件，通过一次预查询取出所有符合条件的图书，避免N+1查询问题。

首先修正你原查询里的笔误：books__published_at__ragne拼写错误，正确为books__published_at__range。

修改后的查询代码如下：

from django.db.models import Count, Prefetch

# 先构造过滤后的图书查询集
filtered_books = Book.objects.filter(published_at__range=[date_from, date_to])

# 查询作者，同时预加载过滤后的图书
authors = Author.objects.filter(
    books__published_at__range=[date_from, date_to]
).annotate(
    books_count=Count('books')
).prefetch_related(
    Prefetch('books', queryset=filtered_books)
).distinct() # 去重，避免跨表join产生重复作者记录

Serializer不需要做任何修改，即可直接返回过滤后的图书列表。

方案2：使用SerializerMethodField在序列化层过滤 #

如果你的过滤参数需要从请求中动态获取，不想在查询层处理，可以修改Serializer实现：

class AuthorSerializer(serializers.ModelSerializer):
    books_count= serializers.IntegerField(read_only=True)
    books = serializers.SerializerMethodField()

    class Meta:
        model = Author
        fields = ['id', 'name', 'books_count', 'books']
    
    def get_books(self, obj):
        # 从序列化上下文获取请求中的日期参数（需要在实例化Serializer时传入context）
        request = self.context.get('request')
        date_from = request.query_params.get('date_from')
        date_to = request.query_params.get('date_to')
        # 转为date类型后过滤关联图书
        filtered_books = obj.books.filter(published_at__range=[date_from, date_to])
        # 等价于原StringRelatedField的输出逻辑
        return [str(book) for book in filtered_books]

注意使用该方案时，需要在实例化Serializer时传入请求上下文：

serializer = AuthorSerializer(authors, many=True, context={'request': request})

该方案适合灵活度要求高的场景，但如果没有搭配预查询，可能会产生N+1性能问题。

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