Django REST Framework中如何过滤嵌套序列化器的职位数据

你之前的尝试未生效，核心原因是instance.jobs是Django的RelatedManager对象，直接赋值过滤后的QuerySet不会改变序列化器读取关联数据的逻辑——序列化器默认会调用jobs.all()获取所有关联职位。下面提供几种可行的实现方案：

方法1：用SerializerMethodField动态过滤 #

在序列化器中定义方法，直接返回过滤后的职位数据，替代原关联字段：

class CategoryJobsSerializer(serializers.ModelSerializer):
    jobs = serializers.SerializerMethodField()

    class Meta:
        model = Category
        fields = ('name', 'description', 'jobs')

    def get_jobs(self, instance):
        # 这里添加过滤规则，示例为只返回全职职位
        filtered_jobs = instance.jobs.filter(job_type="Full Time")
        return JobSerializer(filtered_jobs, many=True).data

这种方式灵活直接，适合固定过滤规则的场景，在序列化阶段完成数据筛选。

方法2：用Prefetch优化查询并过滤 #

如果想在数据库层面完成过滤（减少重复查询，优化性能），可以在视图查询集中用Prefetch预加载并过滤关联职位：

视图修改： #

from django.db.models import Prefetch

class ListCategoryJobs(generics.RetrieveAPIView):
    queryset = Category.objects.all()
    serializer_class = CategoryJobsSerializer
    permission_classes = (AllowAny,)
    filter_backends = [DjangoFilterBackend, filters.SearchFilter]

    def get_queryset(self):
        return Category.objects.prefetch_related(
            Prefetch(
                'jobs',
                queryset=Job.objects.filter(job_type="Full Time"),
                to_attr='filtered_jobs'
            )
        )

序列化器修改： #

class CategoryJobsSerializer(serializers.ModelSerializer):
    jobs = JobSerializer(source='filtered_jobs', many=True, read_only=True)

    class Meta:
        model = Category
        fields = ('name', 'description', 'jobs')

该方案能降低数据库查询次数，适合数据量较大的场景，过滤逻辑在数据库层面完成。

方法3：支持前端传参动态过滤 #

如果需要根据前端传入的参数（如job_type、location）动态过滤，可以结合DjangoFilterBackend实现：

定义过滤类： #

import django_filters

class JobFilter(django_filters.FilterSet):
    job_type = django_filters.CharFilter(field_name='jobs__job_type', lookup_expr='exact')
    location = django_filters.CharFilter(field_name='jobs__location', lookup_expr='icontains')

    class Meta:
        model = Category
        fields = ['job_type', 'location']

视图修改： #

class ListCategoryJobs(generics.RetrieveAPIView):
    queryset = Category.objects.all()
    serializer_class = CategoryJobsSerializer
    permission_classes = (AllowAny,)
    filter_backends = [DjangoFilterBackend]
    filterset_class = JobFilter

    def get_object(self):
        category = super().get_object()
        # 从请求参数中获取过滤条件
        job_type = self.request.query_params.get('job_type')
        location = self.request.query_params.get('location')
        
        filtered_jobs = category.jobs.all()
        if job_type:
            filtered_jobs = filtered_jobs.filter(job_type=job_type)
        if location:
            filtered_jobs = filtered_jobs.filter(location__icontains=location)
        
        category.filtered_jobs = filtered_jobs
        return category

序列化器修改： #

class CategoryJobsSerializer(serializers.ModelSerializer):
    jobs = JobSerializer(source='filtered_jobs', many=True, read_only=True)

    class Meta:
        model = Category
        fields = ('name', 'description', 'jobs')

前端可通过?job_type=Full Time&location=Cairo这类参数，动态筛选分类下的职位。

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