Django如何在单个Serializer中序列化多个关联模型？

实现方法 #

SerializerMethodField的取值方法中，第一个参数obj就是当前正在序列化的UserProfile实例，你可以直接用它获取关联的UserProfilePicture数据，再用对应的序列化器处理后返回即可。

代码示例 #

修改UserProfileSerializer的get_profile_picture方法如下：

from rest_framework.exceptions import NotFound

# 其余代码保持不变
def get_profile_picture(self, obj):
    # obj为当前序列化的UserProfile对象，直接作为过滤条件查询关联表
    try:
        user_picture = UserProfilePicture.objects.get(user_profile=obj)
    except UserProfilePicture.DoesNotExist:
        # 没有对应头像数据时返回空值或默认结构，可根据业务调整
        return None
    # 调用头像序列化器处理数据后返回
    return UserProfilePictureSerializer(user_picture).data

更简化的嵌套序列化器写法 #

如果UserProfile和UserProfilePicture是通过外键/一对一字段直接关联，你甚至不需要用SerializerMethodField，直接嵌套序列化器即可，代码更简洁：

class UserProfileSerializer(serializers.ModelSerializer):
    # 直接声明嵌套的序列化器，DRF会自动根据关联字段取值序列化
    profile_picture = UserProfilePictureSerializer(read_only=True)

    class Meta:
        model = UserProfile
        fields = '__all__'

性能优化建议 #

为了避免序列化时产生N+1查询问题，建议在视图层查询用户数据时，提前预加载关联数据：

@api_view(['GET'])
def get_user_profile_by_name(request, name):
    try:
        # 一对一/外键关联用select_related预加载，反向关联/多对多用prefetch_related
        user_profile = UserProfile.objects.select_related('profile_picture').get(display_name=name.lower())
        serializer = UserProfileSerializer(user_profile, many=False)
        return Response(serializer.data)
    except ObjectDoesNotExist:
        message = {'detail': 'User does not exist or account has been suspended'}
        return Response(message, status=status.HTTP_400_BAD_REQUEST)

如果需要合并更多关联模型的序列化结果，按照上面的逻辑添加对应的嵌套序列化器，同时在视图查询时补充预加载对应的关联字段即可。

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