DRF嵌套序列化器隐藏关联外键报错及规范处理方式咨询

问题根因 #

• 问题1：ItemsSerializer 虽然排除了document字段，但模型层DocumentItem的document外键默认非空，序列化器自动继承模型约束触发必填校验
• 问题2：DRF 原生ModelSerializer的默认create/update方法不支持嵌套字段的写入操作，必须手动实现嵌套数据的持久化逻辑

具体实现步骤 #

步骤1：调整子序列化器的字段配置 #

在ItemsSerializer中显式指定document字段跳过必填校验：

class ItemsSerializer(ModelSerializer):
    class Meta:
        model = DocumentItem
        exclude = ('document', )
        # 新增额外参数配置，标记document非必填
        extra_kwargs = {
            'document': {'required': False}
        }

也可以直接声明字段为只读，效果一致：document = serializers.ReadOnlyField()

步骤2：重写父序列化器的create方法 #

手动处理父实例创建、子实例关联绑定逻辑：

class DocumentSerializer(ModelSerializer):
    items = ItemsSerializer(many=True, required=False)

    class Meta:
        model = Document
        exclude = ()

    def create(self, validated_data):
        # 提取嵌套的子项数据，默认返回空列表
        items_data = validated_data.pop('items', [])
        # 先创建父级Document实例
        document = super().create(validated_data)
        # 批量创建子项并绑定关联关系
        for item_data in items_data:
            DocumentItem.objects.create(document=document, **item_data)
        return document

批量数据场景可使用bulk_create替代循环创建，降低数据库交互次数提升性能

可选：支持嵌套更新场景 #

如果需要适配PUT/PATCH请求的嵌套数据更新，额外重写update方法即可：

def update(self, instance, validated_data):
    items_data = validated_data.pop('items', None)
    # 先更新父实例基础字段
    instance = super().update(instance, validated_data)
    
    if items_data is not None:
        # 可根据业务需求调整为增量更新、比对更新逻辑，此处为全量替换示例
        instance.items.all().delete()
        # 批量创建新的子项
        for item_data in items_data:
            DocumentItem.objects.create(document=instance, **item_data)
    return instance

配置完成后即可实现预期的输入输出格式，前端无需传递document关联字段，存储时会自动绑定父子实例的关联关系。

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