如何在Django REST Framework中自定义序列化器处理创建接口的嵌套POST数据

你可以通过新增一层嵌套包装序列化器、配合重写视图的序列化器选择逻辑与创建逻辑实现需求，不需要修改原有核心业务代码，改动量很小：

1. 定义嵌套包装序列化器 #

保留原有CustomerSerializer不变，新增一层序列化器处理外层的customer嵌套结构：

from rest_framework import serializers, status
from rest_framework.response import Response
from .models import Customer

# 原有业务序列化器保持不变
class CustomerSerializer(serializers.ModelSerializer):
    class Meta:
        model = Customer
        fields = '__all__'

# 新增外层包装序列化器
class CustomerWrapperSerializer(serializers.Serializer):
    # 自定义必填错误提示可匹配你的示例
    customer = CustomerSerializer(
        required=True,
        error_messages={"required": "customer field is required"}
    )

    def create(self, validated_data):
        # 取出嵌套的客户数据创建实例
        customer_data = validated_data.pop('customer')
        return Customer.objects.create(**customer_data)

2. 调整视图逻辑 #

修改CustomerListCreateAPIView，区分请求方法使用对应序列化器，同时调整创建成功后的响应格式：

class CustomerListCreateAPIView(generics.ListCreateAPIView):
    queryset = Customer.objects.all()

    def get_serializer_class(self):
        # POST创建请求用包装序列化器做参数校验
        if self.request.method == 'POST':
            return CustomerWrapperSerializer
        # GET查询请求保持原有逻辑，若需要也返回嵌套结构可自行调整
        return CustomerSerializer

    def create(self, request, *args, **kwargs):
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)
        customer_instance = serializer.save()
        # 按要求包装响应结构
        return Response(
            data={"customer": CustomerSerializer(customer_instance).data},
            status=status.HTTP_201_CREATED
        )

效果说明 #

• 提交参数校验完全符合你的要求：缺少外层customer字段时返回{"customer": "customer field is required"}，内部字段校验错误会自动嵌套在customer字段下返回
• 创建成功后的响应自动按嵌套结构返回，原有列表查询逻辑不受影响，如有需要可自行调整GET请求的响应格式

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