如何序列化Django同一模型中的外键字段

嘿，这个错误我之前也碰到过！问题出在你定义PlayerSerializer的时候，直接在partner字段里写了PlayerSerializer()——这时候Python还没完全把PlayerSerializer这个类定义好呢，自然找不到它，所以才会报"PlayerSerializer未定义"的错。

给你几个靠谱的解决方案，按需选就行：

方案1：用字符串引用序列化器（最省心） #

DRF支持用字符串来指定序列化器类名，这样Python会等整个类都定义完再解析这个引用，完美避开未定义的问题。要是担心出现循环引用（比如两个玩家互为搭档），还能加个depth参数限制嵌套层级：

class PlayerSerializer(serializers.ModelSerializer):
    # 直接用字符串引用当前序列化器
    partner = 'PlayerSerializer'

    class Meta:
        model = Player
        fields = ('id', 'name', 'partner')
        # 可选：限制嵌套深度，防止无限递归炸栈
        depth = 1

方案2：手动控制序列化（应对复杂递归场景） #

如果你的数据存在循环引用的情况，比如A的搭档是B，B的搭档又是A，那方案1可能会触发递归深度超出的错误。这时候可以用SerializerMethodField手动处理，还能自定义返回内容：

class PlayerSerializer(serializers.ModelSerializer):
    partner = serializers.SerializerMethodField()

    def get_partner(self, obj):
        if not obj.partner:
            return None
        
        # 用context跟踪已序列化的玩家ID，避免循环递归
        if 'serialized_ids' not in self.context:
            self.context['serialized_ids'] = set()
        
        if obj.partner.id in self.context['serialized_ids']:
            # 已经序列化过，只返回基础信息
            return {'id': obj.partner.id, 'name': obj.partner.name}
        
        self.context['serialized_ids'].add(obj.partner.id)
        # 递归序列化搭档
        return PlayerSerializer(obj.partner, context=self.context).data

    class Meta:
        model = Player
        fields = ('id', 'name', 'partner')

方案3：只返回搭档ID（最简单的需求场景） #

要是你只需要返回搭档的ID而不是完整的嵌套对象，那直接用PrimaryKeyRelatedField就搞定了，完全没递归烦恼：

class PlayerSerializer(serializers.ModelSerializer):
    partner = serializers.PrimaryKeyRelatedField(
        queryset=Player.objects.all(), 
        blank=True, 
        null=True
    )

    class Meta:
        model = Player
        fields = ('id', 'name', 'partner')

根据你的业务需求选就行，我自己平时用方案1最多，除非碰到复杂的循环引用才会用方案2～

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