如何为DRF OrderingFilter添加close_date与id的二级排序？

你遇到的问题是close_date字段值重复时缺少稳定的二级排序依据，导致查询结果顺序随机。下面是两种可行的实现方案：

方式一：设置默认排序并开放多字段排序 #

直接在你的ListAPIView中指定默认排序规则和允许的排序字段：

from rest_framework.generics import ListAPIView

class YourModelListView(ListAPIView):
    # 修复原代码的元组语法：末尾必须加逗号，否则会被识别为单个字符串
    ordering_fields = ('close_date', 'id')
    # 默认按close_date升序、id升序排序，前端传参时会自动保留二级排序逻辑
    ordering = ('close_date', 'id')

效果说明：

• 前端不指定排序参数时，默认按close_date+id的组合规则排序
• 前端传递?ordering=close_date或?ordering=-close_date时，DRF会自动在指定排序后附加id作为稳定排序条件，避免重复值导致的顺序混乱

方式二：自定义过滤器强制稳定排序 #

如果需要更严格的控制（比如无论前端是否指定排序，只要涉及close_date就自动附加id排序），可以自定义OrderingFilter：

from rest_framework.filters import OrderingFilter

class StableOrderingFilter(OrderingFilter):
    def get_ordering(self, request, queryset, view):
        ordering = super().get_ordering(request, queryset, view)
        if not ordering:
            return ('close_date', 'id')
        
        # 检查排序规则是否包含close_date，且未指定id排序时，自动附加id
        has_close_date = any(field.lstrip('-') == 'close_date' for field in ordering)
        has_id = any(field.lstrip('-') == 'id' for field in ordering)
        
        if has_close_date and not has_id:
            return list(ordering) + ['id']
        
        return ordering

然后在视图中使用自定义过滤器：

class YourModelListView(ListAPIView):
    filter_backends = [StableOrderingFilter]
    ordering_fields = ('close_date', 'id')

关键注意事项 #

原代码中ordering_fields = ('close_date')存在语法错误：这不是元组，会被DRF识别为单个字符串并拆分处理，必须改为('close_date',)或['close_date']的格式。

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