基于DRF与Django Filter实现过滤分面的最佳方案咨询

在DRF+Django Filter的组合里，把分面逻辑集中在FilterSet里确实是更合理的做法——毕竟过滤相关的逻辑就该放在这里，避免代码分散。针对你的需求，以下是几种惯用的实现方案：

核心问题修正：避免全量数据查询 #

你当前的get_first_letter_choices是基于全量Person数据生成选项，这会导致两个问题：一是初始化FilterSet时就触发全表查询，二是选项无法跟随用户的过滤条件动态更新（比如用户筛选了其他条件后，首字母选项应该只包含符合条件的结果）。

方案一：在列表接口中附带分面数据（推荐） #

直接在返回列表结果的同时，返回当前过滤数据集对应的分面选项，既减少请求次数，又能保证数据一致性。

修改视图类的list方法：

# views.py
from rest_framework import ListAPIView, Response
from django.db.models.functions import Substr

class PersonsIndex(ListAPIView):
    filterset_class = PersonFilterSet
    serializer_class = PersonSerializer

    def get_queryset(self):
        return Person.objects.all()

    def list(self, request, *args, **kwargs):
        # 获取经过过滤后的查询集
        queryset = self.filter_queryset(self.get_queryset())
        
        # 生成当前查询集下的首字母分面选项
        facet_letters = queryset \
            .annotate(first_letter=Substr('name', 1, 1)) \
            .values_list("first_letter", flat=True) \
            .distinct() \
            .order_by("first_letter")
        
        # 处理分页并返回结果+分面数据
        page = self.paginate_queryset(queryset)
        if page is not None:
            serializer = self.get_serializer(page, many=True)
            return self.get_paginated_response({
                'results': serializer.data,
                'facets': {
                    'first_letter': [(letter, letter) for letter in facet_letters]
                }
            })
        
        serializer = self.get_serializer(queryset, many=True)
        return Response({
            'results': serializer.data,
            'facets': {
                'first_letter': [(letter, letter) for letter in facet_letters]
            }
        })

方案二：在FilterSet中封装分面逻辑（更内聚） #

把分面生成逻辑直接写在FilterSet里，让视图可以直接调用，进一步集中过滤相关代码：

修改FilterSet类

# filters.py
from django_filters import rest_framework as filters
from django.db.models.functions import Substr
from django.db.models import Count

class PersonFilterSet(filters.FilterSet):
    first_letter = filters.ChoiceFilter(
        field_name="name",
        lookup_expr="startswith"
    )

    class Meta:
        model = Person
        fields = ['first_letter']

    def get_facets(self):
        """基于当前过滤后的查询集生成分面选项（带计数）"""
        queryset = self.qs
        letter_stats = queryset \
            .annotate(first_letter=Substr('name', 1, 1)) \
            .values("first_letter") \
            .annotate(total=Count('id')) \
            .order_by("first_letter")
        
        return {
            'first_letter': [
                (item['first_letter'], f"{item['first_letter']} ({item['total']})")
                for item in letter_stats
            ]
        }

视图中调用FilterSet的分面方法

# views.py
def list(self, request, *args, **kwargs):
    # 显式初始化FilterSet，方便调用其分面方法
    self.filterset = self.get_filterset(self.get_queryset())
    queryset = self.filterset.qs
    
    # 获取分面数据
    facets = self.filterset.get_facets()
    
    # 处理分页和序列化
    page = self.paginate_queryset(queryset)
    if page is not None:
        serializer = self.get_serializer(page, many=True)
        return self.get_paginated_response({
            'results': serializer.data,
            'facets': facets
        })
    
    serializer = self.get_serializer(queryset, many=True)
    return Response({
        'results': serializer.data,
        'facets': facets
    })

关于单独分面接口的疑问 #

单独做一个接口返回分面选项并非不合理，但更推荐和列表接口一起返回：

• 减少HTTP请求次数，提升前端加载效率
• 分面选项和当前过滤结果强绑定，能避免两次请求间数据更新导致的选项不匹配问题
• 符合RESTful设计中“资源集合返回相关元数据”的思路

如果确实需要单独接口（比如前端提前加载选项），可以复用FilterSet的get_facets方法写一个独立视图，避免重复代码。

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