如何在Django Rest Framework中正确实现嵌套序列化器更新？

我来帮你搞定这个问题！你遇到的错误是因为嵌套的UserSerializer默认在执行创建逻辑的校验，它会检查用户名是否已经存在，但我们更新员工时是要修改现有用户的信息，不是新建用户，所以得调整序列化器和视图的逻辑。

问题根源分析 #

1. UserSerializer的校验逻辑：默认情况下，UserSerializer会对username做唯一性校验，但更新现有用户时，这个校验应该忽略当前用户本身，而你的代码里没有让嵌套序列化器知道这是更新操作，所以它还是按照创建新用户的规则来校验。
2. 视图层的错误调用：你手动调用了serializer.update()，但DRF的正确流程是调用serializer.save()，它会自动根据是否传入了instance来决定调用update还是create方法，手动调用update会缺少必要的参数。
3. 序列化器update方法的局限性：你只处理了first_name，没有覆盖所有可能的用户字段，也没有正确利用UserSerializer的更新能力。

具体修改步骤 #

1. 修正EmployeeUpdateSerializer的update方法

我们需要让嵌套的UserSerializer针对现有用户实例执行更新，而不是创建新用户。修改后的序列化器代码如下：

class EmployeeUpdateSerializer(serializers.ModelSerializer):
    user = UserSerializer()
    contract_type = ContractSerializer(read_only=True)
    company = CompanySerializer(read_only=True)
    job_title = JobSerializer(read_only=True)
    department = DepartmentSerializer(read_only=True)
    skill = SkillSerializer(read_only=True)
    unit = UnitSerializer(read_only=True)

    class Meta:
        model = Employee
        # 注意：这里去掉了重复的'induction_date'字段
        fields = ['id', 'user', 'hr_number', 'nssf_no', 'nhif_no', 'induction_date', 'contract_type', 'company', 'tax_id_number', 'joining_date', 'job_title', 'skill', 'unit', 'department', 'identification_number', 'is_manager', 'active']

    def update(self, instance, validated_data):
        # 取出用户更新数据，没有的话就跳过
        user_update_data = validated_data.pop('user', None)
        
        if user_update_data:
            # 用现有用户实例初始化UserSerializer，partial=True允许部分字段更新
            user_serializer = UserSerializer(instance.user, data=user_update_data, partial=True)
            # 校验用户数据，有错误直接抛出
            user_serializer.is_valid(raise_exception=True)
            # 保存用户更新
            user_serializer.save()
        
        # 更新Employee模型的其他字段
        for field, value in validated_data.items():
            setattr(instance, field, value)
        instance.save()
        
        return instance

2. 修正视图层的put方法

视图里不要手动调用update，改用DRF标准的save()方法，同时可以加上partial=True允许部分字段更新（可选，但更灵活）：

class EmployeeDetailView(APIView):
    permission_classes = [AllowAny]
    serializer_class = EmployeeUpdateSerializer

    """ Retrieve, update or delete a employee instance. """
    def get(self, request, pk, format=None):
        try:
            employee = Employee.objects.get(pk=pk)
        except Employee.DoesNotExist:
            raise Http404
        serializer = EmployeeUpdateSerializer(employee)
        return Response(serializer.data, status=status.HTTP_200_OK)

    def put(self, request, pk, format=None):
        try:
            employee = Employee.objects.get(pk=pk)
        except Employee.DoesNotExist:
            raise Http404
        
        # 传入instance和请求数据，partial=True允许只更新部分字段
        serializer = EmployeeUpdateSerializer(employee, data=request.data, partial=True)
        
        if serializer.is_valid():
            # 调用save()会自动触发update方法
            serializer.save()
            return Response(serializer.data, status=status.HTTP_200_OK)
        else:
            return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

为什么这样能解决问题？ #

• 当我们用instance.user初始化UserSerializer时，序列化器知道这是在更新现有用户，此时的唯一性校验会排除当前用户，不会因为用户名和原来相同而报错。
• partial=True允许我们只更新部分用户字段，不需要传入所有User模型的必填字段。
• 调用serializer.save()遵循DRF的标准流程，确保update方法能拿到正确的instance和validated_data。

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