如何在Django项目中自定义序列化器的重复邮箱验证错误响应？

我正在开发一个Django项目，已使用AbstractBaseUser类定义了自定义User模型，相关代码如下：

models.py #

class User(AbstractBaseUser):
    id = models.AutoField(primary_key=True)
    firstname = models.CharField(max_length=50)
    lastname = models.CharField(max_length=50)
    email = models.EmailField(unique=True)
    updated_at = models.DateTimeField(auto_now=True)
    created_at = models.DateTimeField(auto_now_add=True)
    is_staff = models.BooleanField(default=True)
    is_admin = models.BooleanField(default=False)

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['firstname', 'lastname']

    objects = UserManager()

    def save(self, *args, **kwargs):
        if not self.firstname or not self.lastname or not self.email or not self.password:
            raise ValueError('All required fields must be provided')
        super().save(*args, **kwargs)

    def __str__(self):
        return str(self.id) + '. ' + self.firstname + ' ' + self.lastname + ' (' + self.email + ')'

    def has_perm(self, perm, obj=None):
        return self.is_admin

    def has_module_perms(self, app_label):
        return True
    
    class Meta:
        db_table = 'users'
        verbose_name = 'User'
        verbose_name_plural = 'Users'

serializers.py #

from rest_framework import serializers
from .models import *
from django.contrib.auth.hashers import make_password, check_password

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['firstname', 'lastname', 'email', 'password']

    def create(self, validated_data):
        user = User.objects.create_user(
            email = validated_data['email'],
            firstname = validated_data['firstname'],
            lastname = validated_data['lastname'],
            password = make_password(validated_data['password'])
        )
        return user

views.py #

from .models import *
from .serializers import *
from rest_framework.response import Response
from rest_framework.views import APIView

class UserSignup(APIView):
    def post(self, request):
        serializer = UserSerializer(data=request.data)
        if not serializer.is_valid():
            return Response(serializer.errors, status=400)
        serializer.save()
        return Response(serializer.data, status=201)

当前创建重复邮箱的用户时，序列化器返回默认错误响应：

{
    "email": [
        "User with this email already exists."
    ]
}

我希望将该错误提示自定义为"Email already exists."，但不想为修改这一个字段的错误提示而重写所有字段的验证逻辑，请问正确的实现方式是什么？

方法1：在序列化器字段中自定义error_messages #

直接在序列化器中显式声明email字段，仅针对unique错误指定自定义提示，其余验证逻辑保持默认：

class UserSerializer(serializers.ModelSerializer):
    email = serializers.EmailField(
        error_messages={
            'unique': 'Email already exists.'
        }
    )

    class Meta:
        model = User
        fields = ['firstname', 'lastname', 'email', 'password']

    def create(self, validated_data):
        user = User.objects.create_user(
            email = validated_data['email'],
            firstname = validated_data['firstname'],
            lastname = validated_data['lastname'],
            password = make_password(validated_data['password'])
        )
        return user

这种方式只替换email字段的重复值错误提示，邮箱格式校验、必填校验等原有规则完全保留，无需改动其他验证逻辑。

方法2：修改模型字段的错误提示（全局生效） #

如果希望该自定义提示在整个项目中统一生效（比如Django admin后台也使用该提示），可以直接在模型的email字段中配置：

# models.py
email = models.EmailField(
    unique=True,
    error_messages={
        'unique': 'Email already exists.'
    }
)

DRF序列化器会自动复用模型字段的错误配置，无需修改序列化器代码，适合需要全局统一错误信息的场景。

方法3：重写序列化器validate方法修改错误信息 #

若不想显式声明字段，可在序列化器的validate方法中拦截并替换错误信息：

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['firstname', 'lastname', 'email', 'password']

    def create(self, validated_data):
        user = User.objects.create_user(
            email = validated_data['email'],
            firstname = validated_data['firstname'],
            lastname = validated_data['lastname'],
            password = make_password(validated_data['password'])
        )
        return user

    def validate(self, attrs):
        # 先执行默认验证逻辑
        validated_data = super().validate(attrs)
        # 检查并替换email的重复错误提示
        if 'email' in self.errors:
            self.errors['email'] = [msg.replace('User with this email already exists.', 'Email already exists.') for msg in self.errors['email']]
        return validated_data

此方法通过先触发默认验证，再修改已生成的错误信息，同样无需重写完整字段验证逻辑。

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