Serializer字段验证中validate函数失效，调用save()触发TypeError报错

这个报错的核心原因是Serializer的validated_data属性被错误赋值为ValidationError对象，而非验证通过后的字典。调用serializer.save()时，DRF会尝试将validated_data与kwargs合并为新字典，但ValidationError不属于可映射类型（如字典），因此触发类型错误。

1. 全局validate函数错误返回ValidationError #

错误示例：

def validate(self, data):
    if data['status'] != 'active':
        return serializers.ValidationError("状态必须为激活")
    # 未返回验证后的data字典

修复：
抛出ValidationError而非返回，且必须返回验证后的data：

def validate(self, data):
    if data['status'] != 'active':
        raise serializers.ValidationError("状态必须为激活")
    return data  # 必须返回验证通过的字典

2. 手动修改validated_data属性 #

错误示例：

# 在视图中错误赋值
serializer = YourSerializer(data=request.data)
serializer.validated_data = serializers.ValidationError("自定义验证失败")
serializer.save()

修复：
通过is_valid()触发验证流程，不要直接修改validated_data：

serializer = YourSerializer(data=request.data)
serializer.is_valid(raise_exception=True)  # 验证不通过自动抛出异常
serializer.save()

3. 单个字段验证函数错误返回异常 #

错误示例：

def validate_price(self, value):
    if value <= 0:
        return serializers.ValidationError("价格必须大于0")
    return value

修复：
改为抛出ValidationError：

def validate_price(self, value):
    if value <= 0:
        raise serializers.ValidationError("价格必须大于0")
    return value

DRF Serializer的正常验证逻辑：

• 调用is_valid()时，自动执行所有字段验证和全局validate方法
• 验证通过后，validated_data被设置为验证后的字典
• 验证不通过时，is_valid()返回False，errors属性存储错误信息，不会将validated_data设为ValidationError对象
• 仅当代码错误修改validated_data赋值，或验证函数错误返回异常时，才会触发该报错

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