如何使用django-filters实现百分比区间的组合筛选？

问题分析 #

你用三个BooleanFilter的方式会导致条件互斥，因为每个filter方法都是基于前一次的查询集进行过滤。比如同时勾选“高于50%”和“低于50%”，最终查询集是先筛选>50的数据，再从中筛选<50的，结果为空，这显然不是你要的组合效果。另外用union时的报错，是因为Django的union不允许子查询包含ORDER BY，如果原查询集带有排序，就会触发这个错误。

正确实现方案 #

用MultipleChoiceFilter接收多个筛选选项，通过Q对象组合条件，支持单个或多个条件同时生效：

from django.db.models import Q
import django_filters as filters
from .models import Product

class ProductsFilter(filters.FilterSet):
    # 定义筛选选项：key对应筛选逻辑，value为前端显示文本
    PERCENTAGE_CHOICES = (
        ('above', '高于50%'),
        ('below', '低于50%'),
        ('equal', '等于50%'),
    )
    percentage_filter = filters.MultipleChoiceFilter(
        choices=PERCENTAGE_CHOICES,
        method='filter_percentage',
        label='百分比筛选'
    )

    def filter_percentage(self, queryset, name, values):
        # 初始化空的Q对象用于组合条件
        q_objects = Q()
        for value in values:
            if value == 'above':
                # 直接用Decimal字段的比较运算符，避免精度问题
                q_objects |= Q(percentage_field__gt=50)
            elif value == 'below':
                q_objects |= Q(percentage_field__lt=50)
            elif value == 'equal':
                q_objects |= Q(percentage_field=50)
        # 应用组合后的条件
        return queryset.filter(q_objects)

    class Meta:
        model = Product
        fields = ['name', 'price']

方案说明 #

1. MultipleChoiceFilter：允许用户选择多个选项（比如同时选“高于50%”和“等于50%”），前端会传递选中值的列表。
2. Q对象组合：用|（逻辑或）把多个筛选条件组合，最终得到满足任意选中条件的数据集，实现组合筛选效果。
3. Decimal字段适配：直接使用__gt/__lt/=匹配模型的Decimal字段，避免用浮点数（如50.1）和range，防止精度丢失或类型不匹配问题。

替代方案（保留独立参数） #

如果想保留三个独立的筛选参数（比如above_50、below_50、equal_50），可以基于原始查询集副本组合条件：

class ProductsFilter(filters.FilterSet):
    above_50 = filters.BooleanFilter(method='filter_above_50')
    below_50 = filters.BooleanFilter(method='filter_below_50')
    equal_50 = filters.BooleanFilter(method='filter_equal_50')

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 保存原始查询集副本，用于条件合并
        self.original_queryset = self.queryset.all().order_by()  # 去掉排序避免union报错

    def filter_above_50(self, queryset, name, value):
        if value:
            return self.original_queryset.filter(percentage_field__gt=50)
        return queryset

    def filter_below_50(self, queryset, name, value):
        if value:
            return queryset | self.original_queryset.filter(percentage_field__lt=50)
        return queryset

    def filter_equal_50(self, queryset, name, value):
        if value:
            return queryset | self.original_queryset.filter(percentage_field=50)
        return queryset

    class Meta:
        model = Product
        fields = ['name', 'price']

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