Django DRF如何重写关联字段将主图合并到关联图片数组返回

实现方案 #

这部分逻辑优先放在序列化器（Serializer）层面实现，原因很简单：该需求属于接口返回格式的定制，不属于模型通用业务逻辑，也不属于视图路由/查询逻辑，放在序列化器中职责划分最清晰，也方便后续复用调整。

具体实现步骤

1. 修改ProductDetailsSerializer，使用SerializerMethodField自定义photos字段的拼接逻辑，同时移除fields中的main_photo字段：

from rest_framework import serializers

class ProductDetailsSerializer(serializers.ModelSerializer):
    photos = serializers.SerializerMethodField()

    class Meta:
        model = Product
        fields = ('id', 'name', 'photos')
    
    def get_photos(self, obj):
        # 主图放在数组第一位
        photo_list = [obj.main_photo.url]
        # 拼接所有关联的副图URL
        photo_list.extend([item.photo.url for item in obj.photos.all()])
        return photo_list

2. （可选性能优化）在视图的get_queryset方法中添加prefetch_related预加载关联的图片数据，避免N+1查询问题：

class ProductDetailsView(RetrieveAPIView):
    serializer_class = ProductDetailsSerializer

    def get_queryset(self):
        # 预加载photos关联数据，仅执行2次数据库查询
        return Product.objects.all().prefetch_related('photos')

其他层面实现的弊端 #

• 放在Model层面：该拼接逻辑仅为详情接口独有需求，不属于Product模型的通用能力，放到模型中会污染通用方法定义
• 放在View层面：会让视图承担序列化格式处理的职责，违反DRF的分层设计原则，后续如果其他接口需要相同格式还需要重复实现

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