Django-filter配置价格范围筛选不生效问题排查与解决

核心问题 #

配置冲突导致自定义筛选规则未加载：

• 视图中同时定义了filter_class（自定义筛选类）和filterset_fields（快速筛选项），后者会直接覆盖自定义FilterSet的所有配置，你写的price区间规则完全没有被框架读取。
• 新版django-filter已废弃filter_class属性，统一使用filterset_class指定自定义筛选类，旧属性在部分版本下存在识别兼容问题。

修复步骤 #

1. 调整视图层配置 #

移除冲突的filterset_fields配置，替换废弃属性，修改views.py相关代码：

class ApartmentViewSet(viewsets.ModelViewSet):
    queryset = Apartment.objects.all().order_by('-timestamp')
    serializer_class = ApartmentSerializer
    permission_classes = [
        permissions.IsAuthenticatedOrReadOnly, IsOwnerApartmentOrReadOnly]

    filter_backends = [filters.SearchFilter,
                       DjangoFilterBackend, filters.OrderingFilter]
    # 用新版属性指定自定义筛选类
    filterset_class = ApartmentFilter
    search_fields = ['address']
    # 删掉这里的filterset_fields配置，所有筛选项统一放到ApartmentFilter里定义
    ordering_fields = ('price',)

2. 补全自定义筛选类配置 #

把原本写在filterset_fields里的分类、区域筛选项迁移到filters.py的ApartmentFilter中，避免原有筛选功能丢失：

from django_filters import FilterSet
from .models import Apartment

class ApartmentFilter(FilterSet):
    class Meta:
        model = Apartment
        fields = {
            'price': ['lt', 'gt'], # 对应价格上限、下限筛选
            'category': ['exact'], # 分类精确匹配
            'district': ['exact']  # 区域精确匹配
        }

3. 正确传参使用 #

价格区间筛选的参数名为框架自动生成的price__gt（价格大于传入值）、price__lt（价格小于传入值），请求示例：

筛选价格1000-5000、分类id为1、区域id为3的房源，请求路径为：
/apartment/?price__gt=1000&price__lt=5000&category=1&district=3

可选优化 #

如果觉得price__gt/price__lt的参数名不够直观，可以显式定义筛选字段，自定义参数名：

from django_filters import FilterSet, NumberFilter
from .models import Apartment

class ApartmentFilter(FilterSet):
    min_price = NumberFilter(field_name="price", lookup_expr='gt')
    max_price = NumberFilter(field_name="price", lookup_expr='lt')
    
    class Meta:
        model = Apartment
        fields = ['min_price', 'max_price', 'category', 'district']

修改后直接用min_price=1000&max_price=5000传参即可完成价格区间筛选。

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