Django REST Framework如何返回关联模型非嵌套的JSON数据？

方法一：显式声明关联字段（推荐，代码可读性高） #

直接在运动员序列化器中逐个声明需要平铺的会话字段，通过source参数指定关联属性路径，修改AthleteSerializer代码如下：

class AthleteSerializer(serializers.ModelSerializer):
    # 逐个声明Session模型的字段，source指定关联路径
    Id = serializers.IntegerField(source='Session.Id', read_only=True)
    SessionNo = serializers.IntegerField(source='Session.SessionNo', read_only=True)
    WinTeam = serializers.IntegerField(source='Session.WinTeam', read_only=True, allow_null=True)

    class Meta:
        model = Athlete
        # 去掉原来的Session序列化器，加入新增的平铺字段
        fields = ('Age', 'Status', 'Id', 'SessionNo', 'WinTeam')

该方案逻辑清晰、性能最优，适合关联模型字段不多的场景，视图部分无需做任何修改。

方法二：重写序列化方法自动平铺（适合关联字段多的场景） #

如果Session模型字段较多，逐个声明过于繁琐，可以重写序列化器的to_representation方法，自动把嵌套的Session字段合并到外层：

class AthleteSerializer(serializers.ModelSerializer):
    Session = SessionSerializer(read_only=True)

    class Meta:
        model = Athlete
        fields = ('Age', 'Status', 'Session')
    
    def to_representation(self, instance):
        # 先获取默认的序列化结果
        rep = super().to_representation(instance)
        # 取出嵌套的Session数据
        session_data = rep.pop('Session')
        # 把Session的所有字段合并到外层
        rep.update(session_data)
        return rep

该方案无需手动逐个声明字段，后续Session模型新增字段会自动同步到返回结果中，适合字段多、迭代频繁的场景。

注意：如果后续需要同时返回Athlete本身的Id字段，可在合并时给Session的字段加前缀（比如把Id改为SessionId）避免字段名冲突

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