如何在APIView中使用FilterSet与PageNumberPagination？报错求解

报错object of type 'ListSerializer' has no len()的核心原因是：paginate_queryset方法要求传入数据库查询集（QuerySet），但你传入的是序列化器实例（MySerializer对象），它属于ListSerializer类型，没有len()方法，导致分页逻辑无法计算数据长度。

同时，APIView不应该直接继承PageNumberPagination，分页类需要单独实例化使用。

方式一：基于APIView手动实现（自定义流程） #

先定义分页类（可根据需求自定义，也可直接用默认类），再按「过滤→分页→序列化→返回分页响应」的流程实现：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework.exceptions import ValidationError
from rest_framework.pagination import PageNumberPagination
from django_filters import filters

class MySerializer(serializers.ModelSerializer):
    class Meta:
        model = MyModel
        fields = '__all__'

class MyFilter(filters.FilterSet):
    class Meta:
        model = MyModel
        fields = '__all__'

# 自定义分页类（可选，不需要的话可直接用默认PageNumberPagination）
class MyPagination(PageNumberPagination):
    page_size = 10  # 默认每页展示10条
    page_size_query_param = 'page_size'  # 允许通过?page_size=xx自定义每页数量
    max_page_size = 100  # 限制最大每页数量

class MyAPIView(APIView):
    def get(self, request, *args, **kwargs):
        # 1. 获取原始查询集并执行过滤
        queryset = MyModel.objects.all()
        filterset = MyFilter(request.query_params, queryset=queryset)
        
        if not filterset.is_valid():
            raise ValidationError(filterset.errors)
        filtered_queryset = filterset.qs
        
        # 2. 实例化分页类，对过滤后的查询集分页
        paginator = MyPagination()
        paginated_queryset = paginator.paginate_queryset(filtered_queryset, request, view=self)
        
        # 3. 序列化分页后的查询集
        serializer = MySerializer(paginated_queryset, many=True)
        
        # 4. 返回带分页元数据的响应（包含count、next/prev链接等）
        return paginator.get_paginated_response(serializer.data)

方式二：基于GenericAPIView简化实现（推荐） #

GenericAPIView已经集成了过滤、分页、序列化的基础逻辑，配合ListModelMixin可以大幅简化代码：

from rest_framework.generics import GenericAPIView
from rest_framework.mixins import ListModelMixin
from rest_framework.pagination import PageNumberPagination
from django_filters import filters

class MySerializer(serializers.ModelSerializer):
    class Meta:
        model = MyModel
        fields = '__all__'

class MyFilter(filters.FilterSet):
    class Meta:
        model = MyModel
        fields = '__all__'

class MyAPIView(GenericAPIView, ListModelMixin):
    serializer_class = MySerializer
    queryset = MyModel.objects.all()
    filterset_class = MyFilter
    pagination_class = PageNumberPagination  # 或自定义的MyPagination

    def get(self, request, *args, **kwargs):
        return self.list(request, *args, **kwargs)

• 移除APIView对PageNumberPagination的继承，改为在视图内实例化分页类
• paginate_queryset必须传入QuerySet类型的过滤后数据，而非序列化器
• 使用paginator.get_paginated_response返回规范的分页响应，包含分页元数据（总条数、上下页链接等）

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