Django Rest Framework序列化器编写问题求助

针对你遇到的问题，我之前也处理过类似的场景，这里有一个不需要手动编写大量序列化逻辑的可行方案，核心思路是用不同的字段处理输入和输出，同时利用DRF的内置序列化器能力：

步骤1：定义关联对象的精简序列化器 #

先为ModelA和ModelB创建只包含你需要返回字段的序列化器，避免返回冗余信息：

from rest_framework import serializers
from .models import ModelA, ModelB, ModelC

class ModelASerializer(serializers.ModelSerializer):
    class Meta:
        model = ModelA
        fields = ('id', 'name')  # 只返回需要的字段

class ModelBSerializer(serializers.ModelSerializer):
    class Meta:
        model = ModelB
        fields = ('id', 'name', 'attr1')  # 按需求指定返回字段

步骤2：编写ModelC的核心序列化器 #

在ModelC的序列化器中，用PrimaryKeyRelatedField处理输入（接收关联ID并验证实例存在），用上面的精简序列化器处理输出（返回指定关联数据），最后通过to_representation调整输出结构：

class ModelCSerializer(serializers.ModelSerializer):
    # 输入处理：接收ModelA/ModelB的ID，自动验证对应实例存在
    model_a = serializers.PrimaryKeyRelatedField(queryset=ModelA.objects.all())
    model_b = serializers.PrimaryKeyRelatedField(queryset=ModelB.objects.all())

    # 输出处理：只读，返回指定的关联对象数据
    _model_a = ModelASerializer(source='model_a', read_only=True)
    _model_b = ModelBSerializer(source='model_b', read_only=True)

    class Meta:
        model = ModelC
        fields = ('id', 'model_a', 'model_b', '_model_a', '_model_b', 'text', 'date')

    def to_representation(self, instance):
        # 重写该方法，把输出结构调整为你期望的格式
        data = super().to_representation(instance)
        # 替换字段名，去掉临时的下划线前缀
        data['model_a'] = data.pop('_model_a')
        data['model_b'] = data.pop('_model_b')
        return data

步骤3：验证视图逻辑 #

你的现有视图代码不需要大改，只需确保使用上面的ModelCSerializer即可：

from rest_framework import status
from rest_framework.response import Response
from rest_framework.generics import RetrieveUpdateDestroyAPIView
from .serializers import ModelCSerializer

class ModelCApiView(RetrieveUpdateDestroyAPIView):
    serializer_class = ModelCSerializer
    queryset = ModelC.objects.all()  # 这里可以直接写，不用重写get_queryset

    def post(self, request):
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)  # 简化错误处理逻辑
        serializer.save()
        return Response(serializer.data, status=status.HTTP_201_CREATED)

为什么这个方案能解决你的问题？ #

• 解决基础Serializer只返回ID的问题：通过嵌套的精简序列化器，返回你需要的关联对象字段
• 解决depth=1报错的问题：depth会自动嵌套所有关联字段，且在创建时会期望接收完整对象而非ID；这里用PrimaryKeyRelatedField明确指定输入为ID，同时验证实例存在，避免空值错误
• 解决显式子序列化器要求传入完整对象的问题：嵌套序列化器被标记为read_only=True，输入阶段只会处理PrimaryKeyRelatedField的ID，不会要求传入完整关联对象
• 避免双序列化器的冗余：只用一个序列化器完成输入输出处理，通过to_representation调整结构，且关联序列化器只包含必要字段，无冗余信息

测试效果 #

传入数据：

{'model_a': 1, 'model_b': 1, 'text': 'some text', 'date': '2019-08-28 08:00:00'}

返回结果（符合你的期望）：

{'id': 1, 'model_a': {'id': 1, 'name': 'some model a name'}, 'model_b': {'id': 1, 'name': 'some model b name', 'attr1': 'some attr value'}, 'text': 'some text', 'date': '2019-08-28T08:00:00Z'}

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