BaseSerializer中使用自定义验证器返回字段级错误格式的实现疑问

现有实现评价 #

你当前的实现虽然在你的调用场景下可以正常返回预期格式，但存在两处明显问题：

• 逻辑存在bug：代码中else分支的逻辑完全错误，当用户存在且调用时未传field参数时会误抛出验证错误，只是你当前调用时固定传入了field='user_id'，所以暂时没有触发问题
• 复用性差：每次调用验证器都需要手动传入字段名，容易拼写错误，也不适合批量校验场景

更规范的实现方案 #

这里提供3种符合DRF设计规范的实现方式，你可以根据场景选择：

方案1：改造通用字段存在验证器，初始化时绑定参数 #

这种方式避免每次调用都手动传字段名，复用性更高，可适配任意模型的任意字段校验：

class FieldExistsValidator:
    def __init__(self, model, check_field, error_msg=None):
        self.model = model
        self.check_field = check_field
        self.error_msg = error_msg or f"No {model.__name__} matching this {check_field}."
    
    def __call__(self, value, return_field=None):
        # return_field为返回错误时绑定的字段名，不传默认用check_field
        return_field = return_field or self.check_field
        if not self.model.objects.filter(**{self.check_field: value}).exists():
            raise serializers.ValidationError(
                {return_field: self.error_msg}, 
                code="invalid"
            )

使用方法：

class QuestionBaseSerializer(serializers.BaseSerializer):
    def to_internal_value(self, data):
        user_id = data.get('user_id')
        # 初始化时绑定校验模型、校验字段，调用时直接传值即可
        user_validator = FieldExistsValidator(model=User, check_field="id", return_field="user_id")
        user_validator(user_id)
        # 后续其他业务逻辑

方案2：序列化器层统一管理错误结构（适合多字段校验场景） #

如果你有多个字段需要校验，不需要修改原有验证器的逻辑，统一在to_internal_value中捕获错误构造返回结构即可，逻辑拆分更清晰：

class QuestionBaseSerializer(serializers.BaseSerializer):
    def to_internal_value(self, data):
        errors = {}
        user_id = data.get('user_id')
        
        # 校验user_id，原有验证器无需任何修改
        try:
            UserIdExists()(user_id)
        except serializers.ValidationError as e:
            errors["user_id"] = e.detail[0]
        
        # 可继续添加其他字段校验逻辑，统一往errors字典中添加内容
        if errors:
            raise serializers.ValidationError(errors)
        
        # 后续其他业务逻辑

方案3：无需强制使用BaseSerializer时，优先用普通Serializer的字段级验证 #

这是DRF官方最推荐的验证方式，完全贴合框架原生设计，不需要手动处理错误结构：

# 沿用方案1的通用FieldExistsValidator
class QuestionSerializer(serializers.Serializer):
    user_id = serializers.IntegerField(
        validators=[FieldExistsValidator(model=User, check_field="id")]
    )

触发验证错误时会自动返回你需要的字段级错误格式，不需要额外编写to_internal_value相关逻辑。

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