如何在Django REST框架中按模型自定义方法实现排序

Django模型Meta.ordering的逻辑是下推到数据库执行的SQL排序，仅支持数据库中存在的字段、关联字段或可转为SQL的查询表达式，无法直接调用Python层的模型自定义方法。你写的category_name是需要递归拼接生成的路径字符串，属于Python运行时的计算结果，数据库无法识别，直接把方法名写入排序配置既会报错，也无法生效。

另外你当前用的ordering = ['parent_category__name', 'name']逻辑有两个本质缺陷，导致结果不符合预期：

• 无父类的根节点（如Music、Books）的parent_category__name值为NULL，不同数据库对NULL值的默认排序规则不一致，你当前场景下NULL被排在了非NULL值之后，因此有父类的子分类反而排在了根节点前面
• 仅按直接父类的name排序，没有考虑完整路径的字典序规则，会出现跨层级分类错位的问题（比如Books的子分类会因为父类name是Books，排在根节点Music前面，不符合按完整路径排序的预期）

方案1：添加冗余路径字段（推荐，性能最优） #

这是最稳、性能最好的实现方式，尤其适合分类这类数据会动态增长的场景，也是实际项目中树形分类的标准实现方案。

1. 给Category模型新增两个索引字段：

class Category(models.Model):
    # 原有字段保持不变
    name = models.TextField()
    description = models.TextField(null=True)
    color = models.TextField(null=True)
    parent_category = models.ForeignKey(
        'self',
        on_delete=models.SET_NULL,
        null=True,
    )
    # 新增：存储和category_name方法返回值完全一致的完整路径，加索引加速排序
    full_path = models.CharField(max_length=500, db_index=True)
    # 新增：存储分类层级（1为根节点，2为二级分类，以此类推），可选但建议加
    depth = models.PositiveSmallIntegerField(default=1, db_index=True)

    class Meta:
        # 直接按full_path排序即可实现你需要的效果
        ordering = ['full_path']

    def category_name(self):
        if self.parent_category:
            return f"{self.parent_category.category_name()} -> {self.name}"
        return self.name

2. 重写模型的save方法，在保存时自动生成full_path和depth值，和category_name方法的输出保持一致：

def save(self, *args, **kwargs):
    if self.parent_category:
        # 子分类的路径为父类完整路径 + 自身名称
        self.full_path = f"{self.parent_category.full_path} -> {self.name}"
        self.depth = self.parent_category.depth + 1
    else:
        # 根节点路径就是自身名称
        self.full_path = self.name
        self.depth = 1
    super().save(*args, **kwargs)

3. 针对已有的存量分类数据，需要编写数据迁移脚本，批量遍历所有Category生成对应的full_path和depth值，避免新老数据不一致。

实现后排序效果完全符合你的预期：

Books
Music
Music/Guitar
Music/Piano

而且因为是数据库索引字段排序，数据量再大也不会有性能问题。
如果要在DRF中支持前端通过查询参数指定排序，直接用DRF内置的OrderingFilter即可：

from rest_framework.filters import OrderingFilter

class CategoryListView(generics.ListAPIView):
    serializer_class = CategorySerializer
    queryset = Category.objects.all()
    filter_backends = [OrderingFilter]
    # 允许前端按full_path、name等字段排序
    ordering_fields = ['full_path', 'name', 'depth']
    # 默认按full_path升序
    ordering = ['full_path']

前端直接用?ordering=full_path（升序）、?ordering=-full_path（降序）即可控制排序逻辑，不需要写额外代码。

方案2：Python层动态排序（适合小数据量场景） #

如果不想修改表结构，且分类数据量不大（比如总分类数不超过几百个），可以直接把数据查到内存后，用Python层的逻辑生成完整路径再排序，不需要改模型结构。
重写DRF视图的列表方法即可：

class CategoryListView(generics.ListAPIView):
    serializer_class = CategorySerializer

    def list(self, request, *args, **kwargs):
        # 预加载关联的父分类，避免递归查询时出现N+1问题
        queryset = Category.objects.all().prefetch_related('parent_category')
        cat_list = list(queryset)
        # 给每个分类生成完整路径
        for cat in cat_list:
            cat.full_path = cat.category_name()
        # 按完整路径排序
        sorted_cats = sorted(cat_list, key=lambda x: x.full_path)
        # 分页、序列化返回
        page = self.paginate_queryset(sorted_cats)
        if page is not None:
            serializer = self.get_serializer(page, many=True)
            return self.get_paginated_response(serializer.data)
        serializer = self.get_serializer(sorted_cats, many=True)
        return Response(serializer.data)

对应的Serializer中可以把full_path作为输出字段返回给前端：

class CategorySerializer(serializers.ModelSerializer):
    full_path = serializers.SerializerMethodField()
    class Meta:
        model = Category
        fields = ['id', 'name', 'full_path', 'parent_category']
    
    def get_full_path(self, obj):
        return obj.category_name()

方案3：使用树形结构第三方库（适合复杂树形场景） #

如果分类结构后续会变得更复杂（比如需要无限层级、批量移动分类节点等），可以直接用django-treebeard或django-mptt这类成熟的树形结构库，这些库本身就内置了路径字段、层级字段，自带按路径排序的能力，不需要自己实现递归逻辑，长期维护成本更低。

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