使用DRF APIView实现分页遇问题，寻求解决方案

首先，咱们先理清你当前代码的核心问题：你直接返回了序列化后的列表数据，没有用到DRF分页器提供的分页元数据生成方法，所以才看不到页码、下一页这些信息。另外，LimitOffsetPagination本身没有内置的最小结果数配置，需要咱们自定义扩展。

一、先解决分页元数据缺失的问题 #

你当前的代码里，最后用了return Response(response.data)，这只会返回纯数据列表。DRF的分页器自带get_paginated_response()方法，会自动帮你封装总数量、下一页/上一页链接等元数据。修改后的代码如下：

from rest_framework.pagination import LimitOffsetPagination
from rest_framework.response import Response
from rest_framework.views import APIView

class MerchantOrders(APIView):
    authentication_classes = (TokenAuthentication,)
    permission_classes = (IsAuthenticated,)
    
    def get(self, request, pk):
        orders = Order.objects.filter(merchant_id=pk)
        paginator = LimitOffsetPagination()
        result_page = paginator.paginate_queryset(orders, request)
        serializer = ListOrderSerializer(result_page, many=True)
        # 关键：用分页器的get_paginated_response返回
        return paginator.get_paginated_response(serializer.data)

修改后，返回结果会变成这样，包含了分页必要的元数据：

{
    "count": 100,
    "next": "http://your-domain/api/merchants/1/orders?limit=2&offset=2",
    "previous": null,
    "results": [
        // 你的订单数据...
    ]
}

通过next字段是否为null，就能判断是否存在下一页；count是总数据量，结合limit和offset也能算出当前的“逻辑页码”。

二、设置每次请求的最小结果数 #

LimitOffsetPagination没有直接的min_limit配置项，咱们可以自定义一个分页类，重写get_limit方法来实现强制最小数量：

from rest_framework.pagination import LimitOffsetPagination

class CustomLimitOffsetPagination(LimitOffsetPagination):
    default_limit = 10  # 默认每页返回10条
    max_limit = 100     # 限制最大每页数量，防止请求过大
    min_limit = 2       # 你想要设置的最小结果数

    def get_limit(self, request):
        # 先获取用户请求的limit参数，或者默认值
        limit = super().get_limit(request)
        # 如果用户请求的limit小于min_limit，强制返回min_limit
        if limit is not None and limit < self.min_limit:
            return self.min_limit
        return limit

然后在APIView里替换成这个自定义分页器：

def get(self, request, pk):
    orders = Order.objects.filter(merchant_id=pk)
    # 使用自定义分页类
    paginator = CustomLimitOffsetPagination()
    result_page = paginator.paginate_queryset(orders, request)
    serializer = ListOrderSerializer(result_page, many=True)
    return paginator.get_paginated_response(serializer.data)

比如用户请求?limit=1，会自动返回2条数据，满足最小结果数的要求。

三、如果更偏好“页码式”分页（替代LimitOffsetPagination） #

如果你觉得Offset-Limit的方式不够直观，想要直接返回页码信息，可以改用DRF的PageNumberPagination，同样自定义扩展最小页大小：

from rest_framework.pagination import PageNumberPagination

class CustomPageNumberPagination(PageNumberPagination):
    page_size = 10               # 默认每页10条
    page_size_query_param = 'page_size'  # 允许用户通过?page_size=xx自定义每页数量
    max_page_size = 100          # 最大每页数量
    min_page_size = 2            # 最小每页数量

    def get_page_size(self, request):
        page_size = super().get_page_size(request)
        if page_size is not None and page_size < self.min_page_size:
            return self.min_page_size
        return page_size

在APIView中使用后，返回结果会变成这样，包含明确的页码相关信息：

{
    "count": 100,
    "next": "http://your-domain/api/merchants/1/orders?page=2&page_size=2",
    "previous": null,
    "results": [
        // 你的订单数据...
    ]
}

总结 #

• 要返回分页元数据，必须使用分页器的get_paginated_response()方法，而不是直接返回序列化列表
• 设置最小结果数需要自定义分页类，重写对应的获取数量方法（get_limit或get_page_size）
• 可根据业务需求选择Offset-Limit或页码式分页方案

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