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

刚从Node.js转过来用Django DRF，遇到这种读写字段不一致的情况太常见了！核心思路就是实现读写分离的序列化逻辑，让GET请求返回完整的关联数据，POST/PUT请求只需要传入外键ID就行。下面给你两种最常用的方案：

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

这种方法适合逻辑比较简单的场景，在同一个Serializer里同时定义读字段和写字段，通过read_only和write_only参数区分：

from rest_framework import serializers
from .models import Event, CustomUser, ConstructionSite
from .serializers import CustomUserSerializer, ConstructionSiteShortSerializer

class EventSerializer(serializers.ModelSerializer):
    # 读操作时返回完整的用户和工地信息（GET请求用）
    event_posted_by = CustomUserSerializer(read_only=True)
    event_construction_site = ConstructionSiteShortSerializer(read_only=True)
    
    # 写操作时只接受ID（POST/PUT/PATCH请求用）
    # source参数用来指定这个字段对应模型的外键字段，DRF会自动完成关联映射
    event_posted_by_id = serializers.PrimaryKeyRelatedField(
        queryset=CustomUser.objects.all(),
        write_only=True,
        source='event_posted_by'
    )
    event_construction_site_id = serializers.PrimaryKeyRelatedField(
        queryset=ConstructionSite.objects.all(),
        write_only=True,
        source='event_construction_site'
    )

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

说明： #

• read_only=True的字段只会在响应中返回，不会用于验证输入
• write_only=True的字段只会在创建/更新时接受输入，不会出现在响应里
• source参数是关键，它把传入的ID值映射到模型的外键字段（比如event_posted_by），DRF会自动帮你找到对应的用户实例

方案二：拆分出独立的读/写序列化器 #

如果你的读写逻辑差异比较大（比如读的时候需要更多嵌套字段，写的时候有额外的验证逻辑），拆分序列化器会让代码更清晰：

第一步：定义两个序列化器 #

# 用于读操作的序列化器（GET请求）
class ReadEventSerializer(serializers.ModelSerializer):
    event_posted_by = CustomUserSerializer()
    event_construction_site = ConstructionSiteShortSerializer()

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

# 用于写操作的序列化器（POST/PUT/PATCH请求）
class WriteEventSerializer(serializers.ModelSerializer):
    class Meta:
        model = Event
        fields = ('id', 'heading', 'event_posted_by', 'event_construction_site')
        # 这里DRF会自动把外键字段处理成PrimaryKeyRelatedField，前端直接传ID即可

第二步：在ViewSet中根据动作切换序列化器 #

from rest_framework import viewsets
from .models import Event
from .serializers import ReadEventSerializer, WriteEventSerializer

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

    def get_serializer_class(self):
        # 根据当前的API动作选择对应的序列化器
        if self.action in ['list', 'retrieve']:
            return ReadEventSerializer
        # 其他动作（create, update, partial_update, destroy）用写序列化器
        return WriteEventSerializer

说明： #

• self.action会返回当前执行的动作名称，比如list是列表查询，retrieve是详情查询，create是创建资源
• 写序列化器直接使用模型的外键字段，DRF默认会接受ID作为输入，不需要额外配置

额外注意点 #

• 如果你的外键字段是可选的（比如模型里设置了null=True），可以在写字段里加上required=False，允许前端不传该值
• 方案一中的字段名可以自定义，比如把event_posted_by_id改成user_id，只要source参数指向正确的模型字段就可以

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