DRF嵌套序列化器无法保存嵌套字段，仅顶层表入库问题排查

一、原生DRF解决嵌套序列化器保存问题 #

错误原因分析 #

控制台抛出的TypeError: QuestionModel收到意外参数'fieldcontent'，本质是DRF默认不会自动处理嵌套字段的关联保存：当你传递包含fieldcontent的Question数据时，会直接将该参数传入QuestionModel.objects.create()，但QuestionModel本身并没有fieldcontent字段（它是关联FieldcontentModel的关联字段），因此触发错误。

具体解决步骤 #

1. 调整序列化器结构
   确保嵌套序列化器正确关联模型，示例如下：

   from rest_framework import serializers
   from .models import FormularModel, QuestionModel, FieldcontentModel, ResponseModel
   
   class FieldcontentSerializer(serializers.ModelSerializer):
       class Meta:
           model = FieldcontentModel
           fields = '__all__'
   
   class ResponseSerializer(serializers.ModelSerializer):
       class Meta:
           model = ResponseModel
           fields = '__all__'
   
   class QuestionSerializer(serializers.ModelSerializer):
       # 嵌套关联Fieldcontent和Response的序列化器
       fieldcontent = FieldcontentSerializer()
       response = ResponseSerializer(required=False)
   
       class Meta:
           model = QuestionModel
           fields = ['id', 'title', 'fieldcontent', 'response']
   
   class FormularSerializer(serializers.ModelSerializer):
       questions = QuestionSerializer(many=True)
   
       class Meta:
           model = FormularModel
           fields = ['id', 'name', 'questions']
   

2. 重写顶层序列化器的create方法
   手动处理嵌套数据的保存逻辑，先提取嵌套字段数据，再分别创建关联模型：

   class FormularSerializer(serializers.ModelSerializer):
       questions = QuestionSerializer(many=True)
   
       class Meta:
           model = FormularModel
           fields = ['id', 'name', 'questions']
   
       def create(self, validated_data):
           # 取出Question的嵌套数据，避免直接传入FormularModel
           questions_data = validated_data.pop('questions')
           # 创建顶层Formular实例
           formular = FormularModel.objects.create(**validated_data)
   
           # 遍历处理每个Question及其关联模型
           for question_data in questions_data:
               # 取出Fieldcontent数据，避免传入QuestionModel
               fieldcontent_data = question_data.pop('fieldcontent')
               # 取出Response数据（可选）
               response_data = question_data.pop('response', None)
   
               # 创建Question实例，关联到当前Formular
               question = QuestionModel.objects.create(formular=formular, **question_data)
               # 创建Fieldcontent实例，关联到当前Question
               FieldcontentModel.objects.create(question=question, **fieldcontent_data)
               # 若存在Response数据，创建并关联
               if response_data:
                   ResponseModel.objects.create(question=question, **response_data)
   
           return formular
   

二、drf-writable-nested 0.7.0简便实现方式 #

drf-writable-nested可以自动处理嵌套序列化器的创建、更新逻辑，无需手动重写create/update方法，步骤如下：

1. 安装指定版本

   pip install drf-writable-nested==0.7.0
   

2. 使用NestedModelSerializer重构序列化器
   只需将涉及嵌套的序列化器继承自NestedModelSerializer，其余结构保持不变：

   from rest_framework import serializers
   from drf_writable_nested.serializers import NestedModelSerializer
   from .models import FormularModel, QuestionModel, FieldcontentModel, ResponseModel
   
   class FieldcontentSerializer(serializers.ModelSerializer):
       class Meta:
           model = FieldcontentModel
           fields = '__all__'
   
   class ResponseSerializer(serializers.ModelSerializer):
       class Meta:
           model = ResponseModel
           fields = '__all__'
   
   # QuestionSerializer继承NestedModelSerializer，处理自身的嵌套字段
   class QuestionSerializer(NestedModelSerializer):
       fieldcontent = FieldcontentSerializer()
       response = ResponseSerializer(required=False)
   
       class Meta:
           model = QuestionModel
           fields = ['id', 'title', 'fieldcontent', 'response']
   
   # 顶层FormularSerializer继承NestedModelSerializer，处理Question的嵌套
   class FormularSerializer(NestedModelSerializer):
       questions = QuestionSerializer(many=True)
   
       class Meta:
           model = FormularModel
           fields = ['id', 'name', 'questions']
   

   这样配置后，drf-writable-nested会自动处理所有嵌套层级的模型保存，无需手动编写关联逻辑。

注意事项 #

• 确保模型间的外键/关联字段配置正确（如QuestionModel需包含指向FormularModel的外键，FieldcontentModel包含指向QuestionModel的外键）。
• 若嵌套层级超过2层，drf-writable-nested也能支持，但需确保每个层级的序列化器都正确继承NestedModelSerializer。

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