DRF中如何为合并的查询集使用默认过滤与搜索功能？

问题背景 #

合并继承自同一父模型Transactions的PaymentCollection和UpFrontSale模型数据，添加django-filters过滤功能时遇到两个错误：

1. 返回列表导致 AttributeError: 'list' object has no attribute 'model'
2. 使用union合并查询集后，出现 django.db.utils.NotSupportedError: Calling QuerySet.filter() after union() is not supported.

原视图集代码：

class TransactionViewSet(viewsets.ReadOnlyModelViewSet):
    serializer_class = TransactionSerializer
    filter_backends = [DjangoFilterBackend, filters.SearchFilter]
    filterset_fields = {
        "company": ["exact"],
    }
    search_fields = ["id", "description"]

    def get_queryset(self):
        payment_collections = PaymentCollection.objects.all()
        up_front_sales = UpFrontSale.objects.all()

        combined_queryset = list(
            chain(
                payment_collections,
                up_front_sales,
            )
        )

        return combined_queryset

可行解决方案 #

方案1：先过滤子查询集，再合并 #

由于过滤、搜索字段均属于父模型，可先分别对两个子模型的查询集应用过滤条件，再用union合并，避开Django ORM不支持union后过滤的限制。

修改后的视图集代码：

from django.db.models import Q
from rest_framework import viewsets, filters
from django_filters.rest_framework import DjangoFilterBackend

class TransactionViewSet(viewsets.ReadOnlyModelViewSet):
    serializer_class = TransactionSerializer
    filter_backends = [DjangoFilterBackend, filters.SearchFilter]
    filterset_fields = {"company": ["exact"]}
    search_fields = ["id", "description"]

    def get_queryset(self):
        # 提取请求中的过滤参数
        company = self.request.query_params.get("company")
        search_term = self.request.query_params.get("search")

        # 初始化两个子模型查询集
        payments = PaymentCollection.objects.all()
        upfront_sales = UpFrontSale.objects.all()

        # 应用company过滤
        if company:
            payments = payments.filter(company__exact=company)
            upfront_sales = upfront_sales.filter(company__exact=company)

        # 应用搜索过滤
        if search_term:
            search_query = Q(id__icontains=search_term) | Q(description__icontains=search_term)
            payments = payments.filter(search_query)
            upfront_sales = upfront_sales.filter(search_query)

        # 合并查询集（确保两个查询集字段结构一致，因继承自同一父模型，此条件满足）
        return payments.union(upfront_sales)

方案2：自定义FilterSet（进阶） #

如果需要更复杂的过滤逻辑，可以自定义FilterSet，手动处理每个子模型的过滤规则，再合并结果。但本质上还是要先过滤再合并，避免union后调用filter。

关键原因说明 #

• 返回列表会导致Django Filter无法识别：Django Filter依赖QuerySet的model属性来生成过滤规则，列表不具备该属性，因此报错。
• Django ORM不支持union后过滤：SQL层面支持union结果再过滤，但Django ORM未实现此功能，必须先过滤子查询集再合并。

内容的提问来源于stack exchange，提问作者Oskar Adolfo Villa López