如何在DRF ListAPIView返回响应前按所有字段排序序列化数据？

方案1：ORM层面处理排序（推荐，性能最优） #

通过数据库注解（annotate）提前关联并计算需要排序的字段，直接支持序列化器字段名作为排序参数，同时解决自定义字段排序问题。

步骤1：修改视图的get_queryset方法 #

from django.db.models import Count, F, Q
from rest_framework import filters

class teamListView(generics.ListAPIView):
    search_fields = ['teamtranslation_team__team_name']
    filter_backends = (filters.SearchFilter, filters.OrderingFilter)
    # 声明允许排序的序列化器字段名
    ordering_fields = ['team_name', 'team_description', 'members_count', 'company_id', 'has_user']
    serializer_class = teamSerializer
    pagination_class = StandardResultsSetPagination

    def get_queryset(self):
        accessor_id = self.request.user.id
        lang_id = UserProfile.objects.get(user_id=accessor_id).languages_id
        
        # 注解当前用户语言对应的翻译字段、成员数量
        queryset = Team.objects.filter(is_active=True).annotate(
            # 关联当前语言且激活的TeamTranslation的team_name
            team_name=F('teamtranslation_team__team_name'),
            # 关联当前语言且激活的TeamTranslation的team_description
            team_description=F('teamtranslation_team__team_description'),
            # 计算团队成员数量（去重避免重复计数）
            members_count=Count('user', distinct=True)
        ).filter(
            # 过滤出匹配当前语言的激活翻译，或无翻译的团队
            Q(teamtranslation_team__languages_id=lang_id, teamtranslation_team__is_active=True) | 
            Q(teamtranslation_team__isnull=True)
        )

        # 处理排序参数
        ordering = self.request.query_params.get('ordering', 'id')
        order_exprs = []
        for field in ordering.split(','):
            if field.startswith('-'):
                # 倒序，空值后置
                order_exprs.append(F(field[1:]).desc(nulls_last=True))
            else:
                # 正序，空值后置
                order_exprs.append(F(field).asc(nulls_last=True))
        queryset = queryset.order_by(*order_exprs)
        
        return queryset

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

步骤2：简化序列化器 #

由于注解字段已直接映射到序列化器字段，可移除SerializerMethodField，直接使用模型/注解字段：

class teamSerializer(serializers.ModelSerializer):
    team_id = serializers.IntegerField(source='id')
    # 直接使用ORM注解的字段
    members_count = serializers.IntegerField()
    team_description = serializers.CharField(allow_null=True, default='')
    team_name = serializers.CharField(allow_null=True, default='')
    company_code = serializers.CharField(source='company.company_code')

    class Meta:
        model = Team
        fields = ("team_id", "team_name", "team_description", 'members_count', 'company_id', 'company_code', 'has_user')

使用方式 #

• 正序排序：?ordering=team_name
• 倒序排序：?ordering=-members_count
• 多字段排序：?ordering=company_id,-team_name

方案2：序列化后排序（仅适用于小数据量/无分页场景） #

如果无法修改ORM查询，可在序列化完成后对响应数据排序，但注意：分页场景下只会对当前页数据排序，无法实现全局排序。

修改视图的list方法：

def list(self, request, *args, **kwargs):
    # 先获取默认序列化后的响应
    response = super().list(request, *args, **kwargs)
    ordering = request.query_params.get('ordering')
    
    if ordering:
        reverse = False
        sort_field = ordering
        # 处理倒序标记
        if ordering.startswith('-'):
            reverse = True
            sort_field = ordering[1:]
        
        # 对结果列表排序
        response.data['results'] = sorted(
            response.data['results'],
            key=lambda item: item.get(sort_field, ''),
            reverse=reverse
        )
    return response

内容的提问来源于stack exchange，提问作者Abdulkadir Koç