DRF中ModelViewSet读写序列化器分离处理问题咨询

嘿，刚从Node.js转来接触Django DRF的朋友，你碰到的这个问题太典型了——获取数据时需要返回关联对象的详细信息，但创建/更新时只需要传关联对象的ID。DRF里处理这种场景有两种非常实用的方式，我给你详细讲讲：

方法一：拆分读写序列化器（推荐） #

这种方式最清晰，适合大多数场景，尤其是当读写逻辑差异较大的时候。核心思路是分别定义两个序列化器：一个用于读取数据（返回嵌套的关联对象详情），另一个用于写入数据（只接收关联对象的ID），然后在ViewSet里根据请求动作动态切换。

步骤1：定义写入用的序列化器 #

创建一个专门处理创建/更新的序列化器，外键字段用PrimaryKeyRelatedField，这样DRF会自动验证ID的合法性，并且只需要提交ID即可：

class EventWriteSerializer(serializers.ModelSerializer):
    event_posted_by = serializers.PrimaryKeyRelatedField(
        queryset=CustomUser.objects.all(),
        required=True
    )
    event_construction_site = serializers.PrimaryKeyRelatedField(
        queryset=ConstructionSite.objects.all(),
        required=True
    )

    class Meta:
        model = Event
        fields = ('id', 'heading', 'event_posted_by', 'event_construction_site')

步骤2：调整读取用的序列化器 #

把你原来的EventSerializer改成只读模式，给嵌套序列化器加上read_only=True，明确它只用于返回数据：

class EventSerializer(serializers.ModelSerializer):
    event_posted_by = CustomUserSerializer(read_only=True)
    event_construction_site = ConstructionSiteShortSerializer(read_only=True)

    class Meta:
        model = Event
        fields = ('id', 'heading', 'event_posted_by', 'event_construction_site')

步骤3：在ViewSet中动态切换序列化器 #

重写ViewSet的get_serializer_class方法，根据当前的请求动作（比如list/retrieve是读操作，create/update/partial_update是写操作）返回对应的序列化器：

class EventViewSet(viewsets.ModelViewSet):
    queryset = Event.objects.all()

    def get_serializer_class(self):
        # 读操作返回带嵌套详情的序列化器
        if self.action in ['list', 'retrieve']:
            return EventSerializer
        # 写操作返回只接收ID的序列化器
        return EventWriteSerializer

这样处理后，GET请求会返回你预期的关联对象详情，而POST/PUT请求的表单会变成选择或输入ID的字段，完全符合你的需求。

方法二：在同一个序列化器中区分读写字段 #

如果你的读写逻辑差异不大，也可以在同一个序列化器里同时定义读写字段，用read_only和write_only参数区分：

class EventSerializer(serializers.ModelSerializer):
    # 读的时候返回关联对象详情，只读
    event_posted_by_detail = CustomUserSerializer(source='event_posted_by', read_only=True)
    event_construction_site_detail = ConstructionSiteShortSerializer(source='event_construction_site', read_only=True)
    # 写的时候接收关联对象ID，只写
    event_posted_by = serializers.PrimaryKeyRelatedField(queryset=CustomUser.objects.all())
    event_construction_site = serializers.PrimaryKeyRelatedField(queryset=ConstructionSite.objects.all())

    class Meta:
        model = Event
        fields = ('id', 'heading', 'event_posted_by', 'event_construction_site', 'event_posted_by_detail', 'event_construction_site_detail')

这种方式的好处是只用维护一个序列化器，但返回的响应会多两个带_detail后缀的字段，如果你在意响应结构的简洁性，还是第一种拆分的方式更合适。

总的来说，第一种拆分序列化器的方案更推荐，代码结构清晰，后续维护也更方便，尤其当你的业务逻辑越来越复杂时，优势会更明显。

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