如何使用Django Rest Framework高效序列化django-mptt并避免子节点重复返回

你遇到的重复问题本质是视图层默认返回了所有分类条目，包含已经作为子节点存在的二级/多级分类，导致子节点既出现在父分类的children字段中，又单独出现在根返回列表里。

解决方案：调整查询集仅返回根节点 #

django-mptt模型自带root_nodes()方法，可直接筛选所有顶级分类（parent字段为空的分类），子节点会通过你已经编写的RecursiveField自动递归序列化，不会出现遗漏。

类视图修改示例： #

from rest_framework import viewsets
from .models import Category
from .serializers import CategorySerializer

class CategoryViewSet(viewsets.ReadOnlyModelViewSet):
    serializer_class = CategorySerializer
    # 仅返回根节点分类
    queryset = Category.objects.root_nodes()

函数视图修改示例： #

from rest_framework.decorators import api_view
from rest_framework.response import Response
from .models import Category
from .serializers import CategorySerializer

@api_view(['GET'])
def category_list(request):
    # 仅查询根节点分类
    root_categories = Category.objects.root_nodes()
    serializer = CategorySerializer(root_categories, many=True, context={"request": request})
    return Response(serializer.data)

优化建议：避免N+1查询问题 #

如果你的分类层级多、数量大，递归序列化会触发多次数据库查询，可使用django-mptt自带的get_cached_trees()方法预加载所有分类并缓存树结构，大幅减少查询次数：

# 优化后的查询集写法
queryset = Category.objects.get_cached_trees()

前置校验 #

请确保你的Category模型中parent字段的related_name配置为children，和序列化器中的递归字段名对应，否则递归序列化会失效：

from django.db import models
from mptt.models import MPTTModel, TreeForeignKey

class Category(MPTTModel):
    title = models.CharField(max_length=100)
    description = models.TextField(blank=True)
    # 注意related_name必须为children，和序列化器字段匹配
    parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')

    class MPTTMeta:
        order_insertion_by = ['title']

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