DRF中self.paginate_queryset不遵循get_queryset排序问题解决

核心原因 #

重写list方法时，要么没有传入已完成排序的queryset给分页方法，要么分页器没有正确继承原queryset的排序规则。

具体修复步骤 #

1. 确保传入分页方法的是已排序的queryset #

在重写的list方法里，必须先通过self.get_queryset()获取已经经过annotate和排序处理的queryset，再传入paginate_queryset：

from rest_framework.generics import ListAPIView
from rest_framework.response import Response

class KeywordList(ListAPIView):
    # 配置serializer_class等必要属性
    
    def get_queryset(self):
        # 保留原有的annotate逻辑，确保排序规则正确
        return Keyword.objects.annotate(
            mentions=Count('关联模型')  # 替换为你的实际annotate逻辑
        ).order_by('-mentions')  # 按mentions降序排序
    
    def list(self, request, *args, **kwargs):
        # 关键：先获取经过过滤和排序的queryset
        queryset = self.filter_queryset(self.get_queryset())
        
        # 基于已排序的queryset执行分页
        page = self.paginate_queryset(queryset)
        if page is not None:
            serializer = self.get_serializer(page, many=True)
            return self.get_paginated_response(serializer.data)
        
        serializer = self.get_serializer(queryset, many=True)
        return Response(serializer.data)

2. 排查是否意外修改了排序规则 #

检查filter_queryset或其他自定义方法，确认没有在处理过程中重置queryset的排序。比如避免在过滤后重新调用order_by()却未保留原有的-mentions排序规则。

3. 验证分页器逻辑 #

如果使用了自定义分页器，确认分页器没有对queryset执行额外的排序操作。DRF默认分页器会继承queryset本身的排序规则，只要传入的queryset排序正确，分页结果就会保持顺序。

快速验证方法 #

在重写的list方法中，分别打印queryset.first()和page[0]的内容，确认两者是否一致，以此排查是queryset本身排序错误，还是分页过程中出现问题。

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