Django Rest Framework统一设置字段验证错误消息问题求助

这是Django与DRF（Django REST Framework）的验证流程分工导致的：

• max_length验证：DRF序列化器会在字段级别优先执行校验，它读取的是序列化器字段自身的error_messages配置，模型字段中定义的max_length错误消息不会被序列化器读取，因此模型设置里的max_length消息不生效。
• unique验证：唯一性校验属于模型层（数据库约束）的验证逻辑，DRF序列化器在验证流程后期会调用模型的验证机制，所以模型里设置的unique错误消息能生效；但序列化器extra_kwargs中的unique消息无法传递到模型验证环节，因此序列化器设置里的unique消息不生效。

想要在一处完成两种错误消息的自定义，推荐在序列化器中统一处理，有两种简洁方式：

方式1：直接定义序列化器字段 #

from rest_framework.validators import UniqueValidator

class UserSerializer(serializers.ModelSerializer):
    cpf = serializers.CharField(
        max_length=11,
        error_messages={
            "max_length": "你的自定义max_length提示消息",
        },
        validators=[
            UniqueValidator(
                queryset=User.objects.all(),
                message="你的自定义unique提示消息"
            )
        ]
    )

    class Meta:
        model = User
        fields = ("cpf", ...)  # 其他字段

方式2：通过extra_kwargs配置 #

from rest_framework.validators import UniqueValidator

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ("cpf", ...)  # 其他字段
        extra_kwargs = {
            "cpf": {
                "error_messages": {
                    "max_length": "你的自定义max_length提示消息",
                },
                "validators": [
                    UniqueValidator(
                        queryset=User.objects.all(),
                        message="你的自定义unique提示消息"
                    )
                ]
            }
        }

两种方式的核心逻辑一致：

• 通过序列化器字段的error_messages覆盖max_length的默认提示；
• 用DRF的UniqueValidator在序列化器层面处理唯一性校验，替代模型层的默认验证消息，实现统一配置。

内容的提问来源于stack exchange，提问作者vitor.trentim