Django DRF如何为ManyToMany字段新增额外序列化字段并保留原ID列表

解决方案 #

不需要拆分查询和增删改用的Serializer，直接在单个Serializer中自定义字段配置即可实现需求，修改后的代码如下：

class DepartmentSerializer(serializers.ModelSerializer):
    class Meta:
        model = Department
        # 若需要departmentName返回部门ID，记得把id加入字段列表
        fields = ('id', 'name', 'slug', 'image', 'description')


class DoctorSerializer(serializers.ModelSerializer):
    # 显式指定department字段仅处理主键ID，支持读写操作
    department = serializers.PrimaryKeyRelatedField(
        many=True,
        queryset=Department.objects.all()
    )
    # 新增departmentName字段，复用已有DepartmentSerializer输出完整部门信息，仅读
    departmentName = DepartmentSerializer(
        source='department',
        many=True,
        read_only=True
    )

    class Meta:
        model = Doctor
        # 注意要把新增的自定义字段加入fields列表
        fields = (
            'id', 'first_name', 'last_name', 'slug', 'email', 
            'phone', 'title', 'description', 'image', 
            'department', 'departmentName'
        )
        # 删掉原有的depth=1配置，不需要自动展开关联对象

配置说明 #

• 移除原有的depth = 1配置：该配置会自动将所有关联字段深度序列化为完整对象，不符合department只返回ID的需求。
• 显式声明department字段为PrimaryKeyRelatedField：多对多场景下加many=True，指定queryset用于反序列化时校验传入的部门ID合法性，这个字段既可以序列化输出ID数组，也可以在增改操作时直接接收ID数组完成多对多关联绑定，完美适配CRUD需求。
• 自定义departmentName字段：直接复用你已经写好的DepartmentSerializer，通过source='department'指定数据源为模型的department多对多关联，设置read_only=True仅作为输出字段，不参与反序列化校验。

性能优化提示 #

查询列表时为了避免多对多关联产生N+1查询问题，可以在视图层的查询集加上prefetch_related预加载关联的部门数据：

# 示例ViewSet中的queryset配置
queryset = Doctor.objects.all().prefetch_related('department')

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