Django REST Framework：如何为外键序列化器传递查询参数并实现日期过滤

没问题，我来帮你搞定这个需求！要给你的/api/locations/接口加上min_date和max_date查询参数，只返回包含指定时间段内Event的Location，咱们可以通过Django REST Framework（DRF）的过滤功能轻松实现，具体步骤如下：

1. 自定义过滤类（FilterSet） #

首先咱们得创建一个FilterSet类，专门用来处理这两个日期查询参数。因为要过滤的是Location关联的Event的日期，所以得用DRF支持的双下划线__来关联到Event的日期字段（假设你的Event模型里日期字段叫date，如果是其他名字比如start_time，记得替换成你实际的字段名）。

直接上代码示例：

from django_filters import rest_framework as filters
from .models import Location

class LocationFilter(filters.FilterSet):
    # min_date对应Event日期>=指定值
    min_date = filters.DateFilter(field_name='event__date', lookup_expr='gte')
    # max_date对应Event日期<=指定值
    max_date = filters.DateFilter(field_name='event__date', lookup_expr='lte')

    class Meta:
        model = Location
        fields = ['min_date', 'max_date']

2. 在ViewSet中配置过滤逻辑 #

接下来把这个过滤类加到你的LocationViewSet里，同时要启用DRF的DjangoFilterBackend过滤后端，这样接口才能识别并处理这两个查询参数。

代码示例：

from rest_framework import viewsets
from .models import Location
from .serializers import LocationSerializer
from .filters import LocationFilter  # 导入刚才写的过滤类

class LocationViewSet(viewsets.ReadOnlyModelViewSet):  # 换成你实际用的ViewSet类，比如ModelViewSet
    queryset = Location.objects.all()
    serializer_class = LocationSerializer
    # 启用过滤后端
    filter_backends = [filters.DjangoFilterBackend]
    # 指定咱们自定义的过滤类
    filterset_class = LocationFilter

3. 测试接口 #

现在就可以用你给的示例URL测试啦：
/api/locations/?min_date=2018-01-01&max_date=2018-01-15
这个请求会返回所有至少包含一个在指定日期范围内的Event的Location，而且每个Location里依然会嵌入它的所有关联Event（如果需要只返回该时间段内的Event，那还要在Serializer里额外处理，不过你没提这个需求，所以默认保留所有关联数据）。

额外优化（可选） #

• 如果你的Event日期字段不是date，比如是start_date或者event_date，记得把field_name='event__date'改成对应的字段，比如event__start_date。
• 要是你不想用django-filter库，也可以在ViewSet的get_queryset方法里手动处理查询参数，示例如下：

def get_queryset(self):
    queryset = Location.objects.all()
    min_date = self.request.query_params.get('min_date')
    max_date = self.request.query_params.get('max_date')
    
    if min_date:
        queryset = queryset.filter(event__date__gte=min_date)
    if max_date:
        queryset = queryset.filter(event__date__lte=max_date)
    
    # 加.distinct()避免同一个Location因为多个符合条件的Event被重复返回
    return queryset.distinct()

不过还是更推荐用django-filter的方式，更规范也更容易扩展其他过滤条件。

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