如何序列化关联字段同时保留外键字段的HTML下拉表单？

下面提供三种可行的实现方式，按需选择即可：

方法一：覆盖to_representation方法（最简单直观） #

保留DRF默认的外键字段行为（表单显示下拉），仅在序列化输出时替换为嵌套数据：

class VenueSerializer(serializers.ModelSerializer):
    class Meta:
        model = Venue
        fields = "__all__"


class ConventionSerializer(serializers.ModelSerializer):
    class Meta:
        model = Convention
        fields = "__all__"

    def to_representation(self, instance):
        # 获取默认序列化数据（此时venue为ID）
        data = super().to_representation(instance)
        # 将venue字段替换为嵌套的Venue序列化数据
        data['venue'] = VenueSerializer(instance.venue).data if instance.venue else None
        return data

效果：

• 表单页面：venue自动显示为已存在场地的下拉选择框
• API返回：venue输出完整的嵌套对象数据

方法二：使用读写分离的双字段 #

通过两个字段分别处理输入和输出，明确拆分读写逻辑：

class VenueSerializer(serializers.ModelSerializer):
    class Meta:
        model = Venue
        fields = "__all__"


class ConventionSerializer(serializers.ModelSerializer):
    # 输出用：返回嵌套Venue数据，只读
    venue = VenueSerializer(read_only=True)
    # 输入用：显示下拉选择框，只写，关联模型的venue字段
    venue_id = serializers.PrimaryKeyRelatedField(
        queryset=Venue.objects.all(),
        source='venue',
        write_only=True,
        required=False  # 允许未关联场地时添加
    )

    class Meta:
        model = Convention
        fields = ["name", "description", "webpage", "start_date", "end_date", "venue", "venue_id"]

效果：

• 表单页面：仅显示venue_id的下拉选择框（显示名称由Venue模型的__str__方法决定）
• API返回：仅包含venue的嵌套对象数据，不会暴露venue_id

方法三：自定义复合字段 #

创建继承自PrimaryKeyRelatedField的自定义字段，同时支持下拉输入和嵌套输出：

class NestedPrimaryKeyField(serializers.PrimaryKeyRelatedField):
    def to_representation(self, value):
        # 输出时返回嵌套的Venue数据
        return VenueSerializer(value).data


class VenueSerializer(serializers.ModelSerializer):
    class Meta:
        model = Venue
        fields = "__all__"


class ConventionSerializer(serializers.ModelSerializer):
    venue = NestedPrimaryKeyField(queryset=Venue.objects.all())

    class Meta:
        model = Convention
        fields = "__all__"

效果：

• 表单页面：venue字段显示为下拉选择框，与默认外键行为一致
• API返回：venue直接输出嵌套对象数据，无需额外处理

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