Django Filter配置后DRF API无法按URL参数过滤，DateRangeFilter也不生效

• 重写get方法时完全跳过了DRF的内置过滤逻辑：DRF的过滤规则需要通过filter_queryset方法应用到queryset上，默认的ListCreateAPIView会自动调用这个方法，但你重写get后直接使用原始queryset序列化，等于完全没执行过滤流程，和filterset_class的配置完全无关。
• FilterSet字段映射错误：你定义的start_date、end_date绑定的模型字段是date，但Meta类里声明的可用模型字段只有timestamp，说明你的Rainfall模型中大概率没有date这个字段，django-filter找不到对应字段自然无法完成筛选。
• DateRangeFilter使用场景不匹配：如果你需要传入自定义的起止日期做范围过滤，应该用DateFromToRangeFilter，而非DateRangeFilter。后者是预设的快捷范围筛选（比如今天、最近7天这类固定选项），不支持手动传入自定义起止时间。
• 未声明django-filter的过滤后端：DRF默认不会自动启用django-filter，需要显式配置过滤后端，否则就算定义了filterset_class也不会生效。

1. 先确保已安装django-filter，并在settings.py的INSTALLED_APPS中添加django_filters。
2. 配置过滤后端（二选一即可）：
   • 全局配置：在settings.py的REST_FRAMEWORK配置块中添加默认过滤后端：

   REST_FRAMEWORK = {
       'DEFAULT_FILTER_BACKENDS': ['django_filters.rest_framework.DjangoFilterBackend']
   }
   

   • 视图级配置：仅需要过滤的视图中添加filter_backends属性，无需全局生效。
3. 修正FilterSet的字段绑定和范围过滤器：

   from django_filters.rest_framework import FilterSet, DateFilter, DateFromToRangeFilter, DjangoFilterBackend
   
   class RainfallFilter(FilterSet):
       # 把原来的date字段替换为模型实际存在的timestamp字段，lookup_expr用gte/lte更符合日期筛选逻辑
       start_date = DateFilter(field_name='timestamp', lookup_expr='gte')
       end_date = DateFilter(field_name='timestamp', lookup_expr='lte')
       # 自定义范围过滤替换为DateFromToRangeFilter
       date_range = DateFromToRangeFilter(field_name='timestamp')
   
       class Meta:
           model = Rainfall
           fields = ('level', 'amount', 'timestamp')
   

4. 修正视图逻辑：如果没有额外自定义逻辑，直接删掉你重写的get方法即可，父类ListCreateAPIView已经自动处理过滤、序列化流程。如果有额外逻辑，记得手动调用filter_queryset：

   class RainfallView(generics.ListCreateAPIView):
       serializer_class = RainfallSerializer
       queryset = Rainfall.objects.all()
       # 未全局配置后端的话，需要取消下面这行的注释
       # filter_backends = [DjangoFilterBackend]
       filterset_class = RainfallFilter
   
       # 有额外逻辑的get方法示例：
       # def get(self, request, *args, **kwargs):
       #     queryset = self.get_queryset()
       #     # 必须加这行应用过滤规则
       #     queryset = self.filter_queryset(queryset)
       #     serializer = RainfallSerializer(queryset, many=True)
       #     return Response(serializer.data)
   

• 按开始时间筛选：?start_date=2024-01-01
• 按结束时间筛选：?end_date=2024-01-31
• 按自定义时间范围筛选：?date_range_after=2024-01-01&date_range_before=2024-01-31
• 按等级/降雨量筛选：?level=1&amount=10

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