Django：如何覆盖唯一校验器错误信息？配置序列化器后未生效

问题根源 #

你碰到的问题是：序列化器里设置的unique自定义错误信息没起作用，返回的还是数据库层面的默认提示。这是因为序列化器校验通过后，执行serializer.save()时触发了数据库的唯一约束冲突，此时Django会自动把数据库抛出的IntegrityError转换成默认错误信息，完全绕开了你在序列化器里定义的内容。

两种解决方案 #

方案1：显式给字段添加UniqueValidator，把校验拦在序列化器阶段 #

虽然ModelSerializer会根据模型的unique=True自动生成校验器，但显式添加能确保自定义错误信息被正确调用：

from rest_framework.validators import UniqueValidator

class CustomUserSerializer(serializers.ModelSerializer):
    avatar = serializers.FileField(use_url=False, required=False)
    organization = OrganizationSimpleSerializer(required=False, read_only=True)
    user_type = DepartmentSerializer(required=False, read_only=True)

    organization_id = serializers.IntegerField(required=True, write_only=True)
    user_type_id = serializers.IntegerField(required=True, write_only=True)

    # 显式定义字段并添加UniqueValidator
    user_name = serializers.CharField(
        max_length=150,
        validators=[
            UniqueValidator(
                queryset=CustomUser.objects.all(),
                message="Пользователь с таким именем уже существует."
            )
        ]
    )
    email = serializers.EmailField(
        validators=[
            UniqueValidator(
                queryset=CustomUser.objects.all(),
                message="Пользователь с такой электронной почтой уже существует."
            )
        ]
    )
    phone_number = serializers.CharField(
        max_length=20,
        validators=[
            UniqueValidator(
                queryset=CustomUser.objects.all(),
                message="Пользователь с таким телефоном уже существует."
            )
        ]
    )

    class Meta:
        model = CustomUser
        fields = [
            "id", "user_name", "email", "phone_number", "password",
            "avatar", "organization", "user_type", "organization_id", "user_type_id"
            # 补充你实际用到的其他字段
        ]
        read_only_fields = ("id",)
        extra_kwargs = {
            "password": {"write_only": True},
        }

方案2：在视图里捕获数据库异常，手动替换错误信息 #

如果怕并发场景下序列化器校验没拦住（比如两个请求同时提交重复数据），可以在create方法里捕获IntegrityError，把默认错误换成自定义内容：

from django.db import IntegrityError

class CustomUserViewSet(viewsets.ModelViewSet):
    pagination_class = BasePagination
    queryset = CustomUser.objects.all()
    # 其他配置...

    def create(self, request, *args, **kwargs):
        serializer = CustomUserSerializer(data=request.data)

        if serializer.is_valid():
            try:
                user = serializer.save()
                if user:
                    json_data = serializer.data
                    send_invitation_email(
                        user=user,
                        email=json_data["email"],
                        password=request.data["password"],
                        phone=json_data["phone_number"]
                    )
                    create_chats(user)
                    return Response(json_data, status=status.HTTP_201_CREATED)
            except IntegrityError as e:
                error_details = {}
                error_str = str(e)
                # 根据异常信息里的字段名匹配自定义提示
                if "user_name" in error_str:
                    error_details["user_name"] = ["Пользователь с таким именем уже существует."]
                if "email" in error_str:
                    error_details["email"] = ["Пользователь с такой электронной почтой уже существует."]
                if "phone_number" in error_str:
                    error_details["phone_number"] = ["Пользователь с таким телефоном уже существует."]
                if error_details:
                    return Response(error_details, status=status.HTTP_400_BAD_REQUEST)
                # 非重复字段的异常，原样抛出
                raise
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

额外要检查的点 #

• 你代码里先写了extra_kwargs = {}又重新赋值，虽然不影响功能，但建议删掉多余的空字典定义，避免混淆。
• 确认没有其他自定义校验逻辑覆盖了默认的UniqueValidator。

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