Django REST Framework如何自定义同时校验多个字段组合的Validator

核心原理 #

DRF的全局校验逻辑触发时，会传入所有单字段校验完成后的全量字段值字典attrs，你可以从这个字典中读取任意需要的字段做组合判断。

两种实现方案 #

方案1：重写序列化器validate方法（单序列化器专用） #

如果你的校验逻辑只需要在一个序列化器中使用，直接重写序列化器自带的validate方法即可：

from rest_framework import serializers

class DemoSerializer(serializers.Serializer):
    field_1 = serializers.IntegerField()
    field_2 = serializers.IntegerField()

    def validate(self, attrs):
        # 直接从attrs中读取所有已校验字段的值
        field1_val = attrs.get('field_1')
        field2_val = attrs.get('field_2')
        # 替换为你自己的业务校验条件
        if field1_val < field2_val:
            # 也可以将错误绑定到指定字段，格式为raise serializers.ValidationError({"field_1": "错误提示"})
            raise serializers.ValidationError("field1不能小于field2")
        # 必须返回处理后的attrs
        return attrs

方案2：自定义可复用多字段校验器（多序列化器通用） #

如果校验逻辑需要复用到多个序列化器，你可以封装独立的校验器类，初始化时传入要校验的字段名即可：

# 自定义校验器
class CrossFieldValidator:
    def __init__(self, field_a, field_b, error_msg=None):
        self.field_a = field_a
        self.field_b = field_b
        self.error_msg = error_msg or "字段组合校验不通过"

    def __call__(self, attrs):
        val_a = attrs.get(self.field_a)
        val_b = attrs.get(self.field_b)
        # 替换为你的校验条件
        if val_a and val_b and val_a + val_b > 200:
            raise serializers.ValidationError(self.error_msg)

# 序列化器中使用
class DemoSerializer(serializers.Serializer):
    field_1 = serializers.IntegerField()
    field_2 = serializers.IntegerField()
    
    class Meta:
        validators = [
            CrossFieldValidator(field_a="field_1", field_b="field_2", error_msg="两个字段之和不能超过200")
        ]

常见补充说明 #

• 多字段校验的触发时机是所有单字段校验完成后，无需再重复校验单个字段的格式合法性
• 若需要将错误提示关联到指定字段，可传入字典格式的错误信息：raise serializers.ValidationError({"field_1": "该字段和field2组合校验不通过"})

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