如何在Django REST Framework序列化器中封装地址字段为嵌套对象？

要把Listing模型里的地址字段封装到address嵌套对象里，有两种常用方案，根据你的需求选择：

方法一：嵌套序列化器（推荐，支持序列化+反序列化） #

这种方式符合DRF的设计规范，既能生成嵌套格式的响应，也能处理前端传来的嵌套地址数据。

1. 先定义一个处理地址的序列化器，映射模型字段到你需要的键名：

from rest_framework import serializers
from .models import Listing

class AddressSerializer(serializers.Serializer):
    street = serializers.CharField(source='street_address')  # 映射模型的street_address到street
    city = serializers.CharField()
    zip = serializers.CharField(source='postal_code')  # 映射模型的postal_code到zip
    state = serializers.CharField()  # 如果模型有state字段直接添加，可选字段加required=False

2. 修改原有的ListingSerializer，引入这个嵌套序列化器：

class ListingSerializer(serializers.ModelSerializer):
    # source='*'表示把当前Listing实例传给AddressSerializer
    address = AddressSerializer(source='*')

    class Meta:
        model = Listing
        # 明确指定需要返回的字段，避免同时出现扁平地址字段和嵌套对象
        fields = ['name', 'price', 'description', 'address']
        # 或者用exclude排除原地址字段：exclude = ['street_address', 'postal_code', 'city', 'state']

如果需要处理反序列化（比如创建/更新Listing时接收嵌套的address数据），可以在ListingSerializer的create或update方法里拆分address数据，赋值给模型对应的字段：

def create(self, validated_data):
    # 取出address数据
    address_data = validated_data.pop('address')
    # 创建Listing实例
    listing = Listing.objects.create(**validated_data)
    # 更新地址字段
    listing.street_address = address_data['street_address']
    listing.postal_code = address_data['postal_code']
    listing.city = address_data['city']
    listing.state = address_data['state']
    listing.save()
    return listing

方法二：SerializerMethodField（仅序列化场景） #

如果只需要生成嵌套格式的响应，不需要处理反序列化，用这种方式更简单：

class ListingSerializer(serializers.ModelSerializer):
    # 定义address字段，指定用get_address方法生成内容
    address = serializers.SerializerMethodField()

    class Meta:
        model = Listing
        fields = ['name', 'price', 'description', 'address']
        # 同样要排除原地址字段，避免重复输出
        # exclude = ['street_address', 'postal_code', 'city', 'state']

    def get_address(self, obj):
        # obj是当前的Listing模型实例，组装成需要的嵌套字典
        return {
            'street': obj.street_address,
            'city': obj.city,
            'zip': obj.postal_code,
            'state': obj.state
        }

注意事项 #

• 不要直接用fields='__all__'，否则会同时返回扁平的地址字段和嵌套的address对象，必须明确指定需要的字段或者排除原地址字段。
• 如果模型里的某些地址字段是可选的，在序列化器里给对应字段加上required=False参数，避免验证报错。

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