如何在自定义GET方法中使用Django REST Framework过滤器？

你遇到的问题很常见——generics.ListAPIView已经帮你封装了过滤器的执行逻辑，但当你自己写get方法时，就得手动触发这个流程了。先给你梳理下核心原因和解决步骤：

为什么你的自定义GET方法没生效？ #

你当前的代码里用了Profile.objects.get(pk=pk)，这会返回单个Profile实例，而DRF的过滤器是作用于QuerySet（数据集）的，所以根本没法对单个对象应用过滤。另外，你只是在方法里定义了filter_backends和search_fields，但没有实际调用过滤器去处理查询集。

正确的实现方式 #

下面分两种场景给你示例代码：

场景1：视图继承自APIView，复用类配置的过滤器 #

如果你的视图是基于APIView写的，可以把过滤器配置放在类里，和ListAPIView保持一致，然后手动调用过滤方法：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import filters
from .models import Profile
from .serializers import UserContactListSerializer

class ContactDetailView(APIView):
    filter_backends = (filters.SearchFilter,)
    search_fields = ('name', 'last_name',)

    def get(self, request, pk, format=None):
        # 注意：这里要返回QuerySet，而不是单个实例！
        # 比如你要获取某个用户关联的联系人列表，调整为filter而不是get
        queryset = Profile.objects.filter(related_user_id=pk)  # 根据你的业务逻辑修改
        
        # 手动调用类配置的过滤器处理查询集
        filtered_queryset = self.filter_queryset(queryset)
        
        # 序列化时要加many=True，因为是列表数据
        serializer = UserContactListSerializer(filtered_queryset, many=True)
        return Response(serializer.data)

场景2：直接实例化过滤器后端（更灵活） #

如果你不想在类里固定过滤器配置，也可以在方法内直接实例化过滤器后端，按需使用：

def get(self, request, pk, format=None):
    queryset = Profile.objects.filter(related_user_id=pk)
    
    # 实例化SearchFilter并传入参数执行过滤
    search_filter = filters.SearchFilter()
    filtered_queryset = search_filter.filter_queryset(request, queryset, self)
    
    serializer = UserContactListSerializer(filtered_queryset, many=True)
    return Response(serializer.data)

关键要点提醒 #

• 过滤器只能作用于QuerySet，所以一定要避免用get()返回单个对象，改用filter()或者all()获取数据集。
• 如果你的业务确实需要获取单个对象，那过滤逻辑应该提前在QuerySet层面完成（比如先过滤再取单个），而不是拿到对象后再尝试过滤。

内容的提问来源于stack exchange，提问作者Valter Núñez