DRF嵌套序列化器：更新已有对象同时创建关联对象

刚好之前处理过类似的场景，我来一步步帮你实现这个需求——通过一次HTTP请求完成已存在Node1的更新，同时创建关联到同一个Root的Node2。

1. 先明确模型结构（方便对照） #

假设你的模型定义补充示例字段后是这样的：

from django.db import models

class Root(models.Model):
    name = models.CharField(max_length=100)  # 示例业务字段

class Node1(models.Model):
    root = models.OneToOneField(Root, on_delete=models.CASCADE, related_name='node1')
    field1 = models.CharField(max_length=100)  # Node1的业务字段

class Node2(models.Model):
    root = models.OneToOneField(Root, on_delete=models.CASCADE, related_name='node2')
    field2 = models.CharField(max_length=100)  # Node2的业务字段

2. 定义嵌套序列化器 #

核心思路是在Node1的序列化器里嵌套Node2的序列化器，然后重写update方法手动处理Node2的创建逻辑（DRF默认不会自动处理嵌套的创建操作）：

from rest_framework import serializers
from .models import Node1, Node2

class Node2Serializer(serializers.ModelSerializer):
    class Meta:
        model = Node2
        fields = ['field2']  # 不需要包含root字段，我们会手动关联到已有的Root

class Node1Serializer(serializers.ModelSerializer):
    # 嵌套Node2序列化器，用于接收创建Node2的参数
    node2 = Node2Serializer()

    class Meta:
        model = Node1
        fields = ['field1', 'node2']  # 包含Node1的字段和嵌套的node2字段

    def update(self, instance, validated_data):
        # 先从验证后的数据中提取Node2的参数
        node2_data = validated_data.pop('node2')
        
        # 调用父类的update方法，先完成Node1的字段更新
        instance = super().update(instance, validated_data)
        
        # 检查当前Root是否已经关联了Node2（避免重复创建）
        if hasattr(instance.root, 'node2'):
            raise serializers.ValidationError("该Root已经关联了Node2，无法重复创建")
        
        # 创建Node2并关联到同一个Root
        Node2.objects.create(root=instance.root, **node2_data)
        
        return instance

3. 编写视图 #

用DRF的RetrieveUpdateAPIView来处理更新请求，它自带了详情获取和PUT更新的逻辑：

from rest_framework.views import RetrieveUpdateAPIView
from .models import Node1
from .serializers import Node1Serializer

class Node1UpdateWithNode2CreateView(RetrieveUpdateAPIView):
    queryset = Node1.objects.all()
    serializer_class = Node1Serializer
    # 可以根据项目需求添加权限认证，比如：
    # permission_classes = [IsAuthenticated]

4. 配置URL #

把视图映射到具体的URL路径：

from django.urls import path
from .views import Node1UpdateWithNode2CreateView

urlpatterns = [
    path('node1/<int:pk>/', Node1UpdateWithNode2CreateView.as_view(), name='node1-update-create-node2'),
]

5. 测试请求 #

发送PUT请求到/node1/{node1_id}/，请求体JSON示例如下：

{
    "field1": "更新后的Node1字段值",
    "node2": {
        "field2": "新创建的Node2字段值"
    }
}

可选扩展：支持更新已存在的Node2 #

如果你的需求需要兼容“更新已存在的Node2”而不是只创建，可以把update方法里的创建逻辑改成get_or_create：

def update(self, instance, validated_data):
    node2_data = validated_data.pop('node2')
    instance = super().update(instance, validated_data)
    
    # 获取或创建Node2，存在则更新字段
    node2, created = Node2.objects.get_or_create(root=instance.root, defaults=node2_data)
    if not created:
        # 更新已存在的Node2字段
        for attr, value in node2_data.items():
            setattr(node2, attr, value)
        node2.save()
    
    return instance

这样不管Node2是否存在，都能正常处理更新或创建的逻辑。

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