如何在Django Rest Framework中修改默认non_field_errors提示信息

你之前的代码无效的原因是：extra_kwargs仅用于配置序列化器中具体字段的错误信息，non_field_errors不属于字段范畴，所以通过这种方式无法修改它的提示内容。

下面是几种可行的解决方法：

方法一：重写序列化器的validate方法手动校验 #

在序列化器中直接检查唯一约束条件，抛出自定义的验证错误：

from rest_framework.exceptions import ValidationError

class ItemSerializer(serializers.ModelSerializer):
    class Meta:
        model = Item
        fields = "__all__"

    def validate(self, data):
        # 根据你的实际唯一约束调整查询条件，这里假设是name字段唯一
        name = data.get("name")
        # 如果是更新操作，需要排除当前实例
        if self.instance:
            exists = Item.objects.filter(name=name).exclude(id=self.instance.id).exists()
        else:
            exists = Item.objects.filter(name=name).exists()
        
        if exists:
            raise ValidationError("There exists an item with this name already!")
        return data

方法二：在模型层定义约束时指定错误信息 #

如果你的唯一约束是通过Django模型的UniqueConstraint定义的（Django 2.2及以上版本支持），可以直接在约束中设置自定义提示：

from django.db import models

class Item(models.Model):
    name = models.CharField(max_length=100)
    # 其他字段定义...

    class Meta:
        constraints = [
            models.UniqueConstraint(
                fields=["name"], 
                name="unique_item_name", 
                message="There exists an item with this name already!"
            )
        ]

这种方式会让数据库层面的唯一约束触发时，直接返回你设置的错误信息，无需在序列化器中额外处理。

方法三：自定义全局异常处理器 #

如果需要统一处理多个模型的唯一约束错误，可以自定义DRF的异常处理器，捕获数据库的IntegrityError并替换错误信息：

# 在项目的utils.py或其他合适的文件中
from rest_framework.views import exception_handler
from django.db import IntegrityError

def custom_exception_handler(exc, context):
    # 先调用DRF默认的异常处理逻辑
    response = exception_handler(exc, context)
    
    # 捕获唯一约束相关的IntegrityError
    if isinstance(exc, IntegrityError) and "unique constraint" in str(exc).lower():
        response.data = {"non_field_errors": ["There exists an item with this name already!"]}
    
    return response

然后在项目的settings.py中配置使用这个自定义处理器：

REST_FRAMEWORK = {
    "EXCEPTION_HANDLER": "your_project_name.utils.custom_exception_handler"
}

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