Django Rest Framework使用to_representation合并关联模型字段问题

方案1：通过重写to_representation自动合并字段（适合Game字段较多的场景） #

步骤1：定义Game基础序列化器 #

from rest_framework import serializers
from .models import Player, Game, GameMembership

class GameSerializer(serializers.ModelSerializer):
    class Meta:
        model = Game
        fields = '__all__' # 可替换为你需要暴露的Game字段列表

步骤2：定义中间表序列化器，实现字段平铺 #

class PlayerGameSerializer(serializers.ModelSerializer):
    class Meta:
        model = GameMembership
        fields = ['available']
    
    def to_representation(self, instance):
        # 合并中间表自有字段和关联Game字段，平铺到同一层级
        base_data = super().to_representation(instance)
        game_data = GameSerializer(instance.game).data
        return {**base_data, **game_data}

步骤3：定义Player序列化器，重命名字段 #

class PlayerSerializer(serializers.ModelSerializer):
    # 将原关联的memberships字段重命名为games，使用自定义的序列化器渲染
    games = PlayerGameSerializer(source='memberships', many=True, read_only=True)

    class Meta:
        model = Player
        fields = ['id', 'first_name', 'games'] # 按需添加其他Player字段

步骤4：优化ViewSet查询，避免N+1性能问题 #

from rest_framework import viewsets
from .models import Player
from .serializers import PlayerSerializer

class PlayerViewSet(viewsets.ModelViewSet):
    # 预加载关联的membership和game数据，减少数据库查询次数
    queryset = Player.objects.all().prefetch_related('memberships__game')
    serializer_class = PlayerSerializer

方案2：显式声明所有字段（适合需要精准控制返回字段的场景） #

不需要重写to_representation，直接在序列化器中显式声明Game的对应字段，通过source指定关联路径：

class PlayerGameSerializer(serializers.ModelSerializer):
    # 逐个声明需要暴露的Game字段，source指向关联game对象的对应属性
    game_id = serializers.IntegerField(source='game.id', read_only=True)
    date = serializers.DateField(source='game.date', read_only=True)
    # 其他Game字段按同样格式添加

    class Meta:
        model = GameMembership
        fields = ['available', 'game_id', 'date'] # 把所有需要的字段都加入列表

Player序列化器和ViewSet的写法和方案1完全一致。 #

两种方案最终返回的结构都会符合要求，games数组下每个元素直接包含available字段和所有Game字段，不需要嵌套访问。

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