如何在Django REST Framework中为字段空输入自定义验证错误？

问题原因 #

当你给CharField设置required=True时，Django REST Framework（DRF）会在字段专属验证（validate_name）和全局验证（validate）之前执行基础校验：

• 如果请求中完全没有传递name字段，直接触发required默认错误
• 如果传递了name但值为空字符串（CharField默认allow_blank=False），直接触发blank默认错误
  这两种情况都不会进入你自定义的验证方法，所以你的自定义错误不会生效。

解决方案 #

方案1：直接在字段定义中自定义错误信息（推荐）

不需要修改验证方法，直接通过字段的error_messages参数覆盖默认提示，同时保留required=True的校验逻辑：

from rest_framework import serializers

class YourSerializer(serializers.Serializer):
    name = serializers.CharField(
        required=True,
        error_messages={
            'required': '请填写名称，此字段不能为空',
            'blank': '名称不能为空，请输入有效内容'
        }
    )
    # 其他字段...

• required对应未传递name字段的场景
• blank对应传递了但值为空字符串的场景

方案2：通过自定义验证方法实现（适合需额外复杂校验的场景）

先将required设为False，绕过DRF的提前校验，再在自定义验证方法中手动判断空值：

方式A：字段专属验证方法

class YourSerializer(serializers.Serializer):
    name = serializers.CharField(required=False)

    def validate_name(self, value):
        # 判断空值（含空字符串、仅空格的情况）
        if not value or not value.strip():
            raise serializers.ValidationError('名称不能为空，请填写有效内容')
        # 这里可以添加其他针对name字段的自定义校验逻辑
        return value

方式B：全局验证方法

class YourSerializer(serializers.Serializer):
    name = serializers.CharField(required=False)

    def validate(self, data):
        name = data.get('name', '').strip()
        if not name:
            raise serializers.ValidationError({'name': '名称不能为空，请填写有效内容'})
        # 这里可以添加其他全局校验逻辑
        return data

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