如何在Django REST Framework中实现无嵌套自定义序列化格式

完全可以通过Django REST Framework（DRF）的序列化器机制实现你想要的格式，不需要手动将查询集转为列表或字典处理。以下是两种可行的实现方式：

方式一：重写序列化器的to_representation方法 #

这种方式基于现有的ModelSerializer，通过重写序列化逻辑来重组输出结构：

1. 定义基础序列化器 #

from rest_framework import serializers
from .models import Task, Offer

class TaskSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ("id", "description")  # 根据需求添加Task的字段

class OfferSerializer(serializers.ModelSerializer):
    class Meta:
        model = Offer
        fields = ("id", "type", "price")  # 根据需求添加Offer的字段

2. 自定义序列化器实现结构重组 #

class CustomOfferSerializer(serializers.ModelSerializer):
    # 先序列化关联的Task
    task = TaskSerializer(read_only=True)

    class Meta:
        model = Offer
        fields = ("id", "type", "task")

    def to_representation(self, instance):
        # 获取父类序列化后的原始数据
        original_data = super().to_representation(instance)
        # 重组为目标格式
        return {
            "offer": {
                "id": original_data["id"],
                "type": original_data["type"]
                # 可按需添加其他Offer字段，比如price
            },
            "task": original_data["task"]
        }

3. 视图中使用该序列化器 #

注意用select_related优化查询，避免N+1数据库查询问题：

from rest_framework.response import Response
from rest_framework.views import APIView
from .models import Offer
from .serializers import CustomOfferSerializer

class OfferListView(APIView):
    def get(self, request):
        # 预加载关联的Task，提升性能
        offers_queryset = Offer.objects.all().select_related("task")
        serializer = CustomOfferSerializer(offers_queryset, many=True)
        return Response(serializer.data)

方式二：使用你期望的TasksOffersSerializer结构 #

直接基于Serializer定义结构，通过SerializerMethodField分别序列化Offer和Task：

1. 定义目标序列化器 #

class TasksOffersSerializer(serializers.Serializer):
    task = serializers.SerializerMethodField()
    offer = serializers.SerializerMethodField()

    def get_task(self, obj):
        # obj是传入的Offer实例，直接序列化其关联的task
        return TaskSerializer(obj.task).data

    def get_offer(self, obj):
        # 序列化当前Offer实例
        return OfferSerializer(obj).data

2. 视图中使用 #

同样记得用select_related优化查询：

class OfferListView(APIView):
    def get(self, request):
        offers_queryset = Offer.objects.all().select_related("task")
        serializer = TasksOffersSerializer(offers_queryset, many=True)
        return Response(serializer.data)

关键优化点 #

• 必须使用select_related("task")：因为每个Offer都需要关联的Task数据，这个方法会让Django ORM执行一次JOIN查询，避免循环查询每个Offer对应的Task（N+1问题），大幅提升性能。

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