Django中如何将Serializer的partial参数传递给嵌套子序列化器

问题本质 #

• DRF视图集处理PATCH请求时，会自动为绑定的主序列化器传入partial=True，开启部分更新校验逻辑，允许请求只传需要修改的字段
• 主序列化器中声明的嵌套子序列化器不会自动继承父级的partial配置，哪怕父级处于部分更新模式，嵌套层依然会执行全量校验，强制要求所有必填字段传值
• 之前尝试的SerializerMethodField方案无效，核心原因是SerializerMethodField属于只读字段，仅在序列化输出（构造响应数据）阶段执行，完全不参与反序列化（请求参数校验、数据写入）流程，在get_*方法中传递partial参数不会对入参校验产生任何作用

可行实现方案 #

方案1：单序列化器直接透传（适配少量嵌套字段场景） #

重写父序列化器的__init__方法，在初始化完成后，将partial状态同步给对应的嵌套序列化器字段即可：

from rest_framework import serializers
from .models import Book, Chapter

class ChapterSerializer(serializers.ModelSerializer):
    class Meta:
        model = Chapter
        fields = "__all__"

class BookSerializer(serializers.ModelSerializer):
    chapters = ChapterSerializer(many=True, required=False)

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 父级开启partial时，同步给嵌套的chapters字段
        if self.partial:
            self.fields["chapters"].partial = True

注：嵌套字段设置many=True时，外层是ListSerializer包装实例，直接给该实例设置partial=True后，ListSerializer会在遍历处理每一条子数据时，自动将partial参数传递给内部的单实例ChapterSerializer，无需额外处理ListSerializer内部逻辑。

方案2：公共Mixin透传（适配多嵌套字段/多层嵌套场景） #

如果序列化器存在多个嵌套字段，或者嵌套层级较深，可以封装通用Mixin自动完成所有嵌套序列化器的partial参数同步，减少重复代码：

from rest_framework import serializers

class NestedPartialSupportMixin:
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        if not self.partial:
            return
        # 遍历所有字段，为嵌套序列化器同步partial状态
        for field in self.fields.values():
            if isinstance(field, serializers.BaseSerializer):
                field.partial = True

# 实际使用
class BookSerializer(NestedPartialSupportMixin, serializers.ModelSerializer):
    chapters = ChapterSerializer(many=True, required=False)
    # 其余嵌套字段会自动同步partial配置
    class Meta:
        model = Book
        fields = "__all__"

注意事项 #

• 以上配置仅解决嵌套层的校验规则继承问题，DRF本身默认不支持嵌套关系数据的写入，仍然需要自行重写BookSerializer的update方法，实现章节数据的新增、修改、删除逻辑
• 提供的请求示例存在JSON语法错误：章节的title字段值为字符串类型，需要用双引号包裹，否则会触发JSON解析失败，调试时需要修正

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