如何覆写Django Rest Framework序列化器验证？验证方法未触发排查

这个问题我之前也碰到过，核心原因是你用错了字段类型——SerializerMethodField是专门用于序列化输出的只读字段，它只会在把模型数据转成响应格式时，调用get_categories方法生成返回值，完全不参与反序列化（处理前端请求输入）的流程。

DRF会自动忽略只读字段的输入数据：既不会把请求里的categories数组传给这个字段，也不会触发它对应的validate_categories验证方法。这就是为什么你打印的内容从未执行，而对象能创建成功，大概率是因为你模型里的categories字段允许为空或者有默认值。

要实现「接收数组→转逗号字符串存库；读库时逗号字符串转数组/选项文本」的需求，有两种常用方案：

方案1：拆分输入输出字段（逻辑更清晰） #

定义两个字段：一个用于接收前端输入的数组（标记为write_only），一个用于输出处理后的格式（标记为read_only）：

class DeviceSerializer(HALSerializer):
    # 输出用：只读，把库中的逗号字符串转成选项文本数组
    categories = serializers.SerializerMethodField(read_only=True)
    # 输入用：只写，接收前端传来的字符串数组，映射到模型的categories字段
    categories_input = serializers.ListField(
        child=serializers.CharField(max_length=20),
        write_only=True,
        source='categories'
    )

    class Meta:
        model = Device
        fields = ('_links', 'id', 'name', 'age', 'categories', 'categories_input')

    def get_categories(self, obj):
        if not obj.categories:
            return []
        # 先拆分逗号字符串为数组，再转成对应的选项文本
        return [obj.categories.choices[key.upper()] for key in obj.categories.split(',')]

    def validate_categories_input(self, categories):
        # 验证每个分类是否合法（比如是否在choices的键中）
        valid_keys = self.Meta.model.categories.choices.keys()
        for key in categories:
            upper_key = key.upper()
            if upper_key not in valid_keys:
                raise serializers.ValidationError(f"无效的分类：{key}")
        # 把数组转成逗号分隔的字符串返回，自动存入模型的categories字段
        return ','.join([upper_key for upper_key in map(str.upper, categories)])

    def create(self, validated_data):
        # validated_data里的'categories'已经是处理后的逗号字符串了
        return Device.objects.create(**validated_data)

方案2：重写字段的序列化/反序列化方法（代码更简洁） #

如果不想多一个字段，可以直接用CharField，然后重写to_internal_value（处理输入）和to_representation（处理输出）方法：

class DeviceSerializer(HALSerializer):
    categories = serializers.CharField(allow_blank=True, required=False)

    class Meta:
        model = Device
        fields = ('_links', 'id', 'name', 'age', 'categories')

    def to_internal_value(self, data):
        # 处理前端输入：把数组转成逗号分隔的字符串
        if 'categories' in data and isinstance(data['categories'], list):
            data['categories'] = ','.join(map(str.upper, data['categories']))
        return super().to_internal_value(data)

    def to_representation(self, instance):
        # 处理输出：把逗号字符串转成选项文本数组
        representation = super().to_representation(instance)
        if instance.categories:
            representation['categories'] = [
                instance.categories.choices[key.upper()] 
                for key in instance.categories.split(',')
            ]
        else:
            representation['categories'] = []
        return representation

    def validate_categories(self, value):
        # 现在这个方法会被正常调用了！
        print("IN THE VALIDATOR")
        # 验证逻辑：检查每个分类是否合法
        if value:
            valid_keys = self.Meta.model.categories.choices.keys()
            for key in value.split(','):
                if key not in valid_keys:
                    raise serializers.ValidationError(f"无效的分类：{key}")
        return value

    def create(self, validated_data):
        return Device.objects.create(**validated_data)

• SerializerMethodField仅用于输出序列化，永远不会处理输入数据，对应的validate_xxx方法也不会被触发；
• 处理输入输出格式不一致的场景，要么拆分字段（读写分离），要么重写字段的to_internal_value和to_representation方法；
• 验证方法validate_xxx只会作用于参与反序列化的字段，也就是那些会处理输入的字段。

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