Django REST Framework统一转换模型层ValidationError为Serializer异常

这确实是DRF开发中很常见的痛点——模型层的验证逻辑抛出的django.core.exceptions.ValidationError会触发500服务器错误，而序列化器内抛出的serializers.ValidationError却能返回格式规范的400响应。不想每个序列化器都重复写异常捕获逻辑的话，有两种高效的全局处理方案：

方案一：自定义DRF全局异常处理器（推荐） #

DRF允许我们覆盖默认的异常处理函数，全局捕获模型层的验证异常并转换成DRF规范的400响应。

步骤1：编写自定义异常处理器 #

在项目的工具模块（比如utils.py）中添加以下代码：

from rest_framework.views import exception_handler
from django.core.exceptions import ValidationError as DjangoValidationError
from rest_framework import serializers

def custom_exception_handler(exc, context):
    # 先调用DRF默认的异常处理器，获取基础响应结构
    response = exception_handler(exc, context)

    # 捕获Django模型层抛出的ValidationError
    if isinstance(exc, DjangoValidationError):
        # 将Django的验证异常转换为DRF的ValidationError
        drf_validation_exc = serializers.ValidationError(
            f"Model level validation error: {str(exc)}"
        )
        # 让默认处理器处理转换后的异常，生成规范的400响应
        response = exception_handler(drf_validation_exc, context)

    return response

步骤2：配置DRF使用自定义处理器 #

在项目的settings.py中修改REST_FRAMEWORK配置：

REST_FRAMEWORK = {
    # 替换默认的异常处理器为我们自定义的
    'EXCEPTION_HANDLER': 'your_project_name.utils.custom_exception_handler',
    # 其他DRF配置...
}

优点：全局生效，覆盖所有场景（包括视图中直接调用模型save()的情况），无需修改任何序列化器或视图代码。

方案二：自定义基类序列化器 #

如果不想修改全局异常处理逻辑，可以创建一个基类序列化器，把异常捕获逻辑封装进去，让所有业务序列化器继承这个基类。

编写基类序列化器 #

from rest_framework import serializers
from django.core.exceptions import ValidationError as DjangoValidationError

class BaseModelSerializer(serializers.ModelSerializer):
    def perform_create(self, validated_data):
        try:
            return super().perform_create(validated_data)
        except DjangoValidationError as err:
            raise serializers.ValidationError(
                f"Model level validation assertion -- {str(err)}"
            ) from err

    def perform_update(self, instance, validated_data):
        try:
            return super().perform_update(instance, validated_data)
        except DjangoValidationError as err:
            raise serializers.ValidationError(
                f"Model level validation assertion -- {str(err)}"
            ) from err

业务序列化器继承基类 #

class YourModelSerializer(BaseModelSerializer):
    class Meta:
        model = YourModel
        fields = "__all__"

优点：更灵活，可选择性地让部分序列化器生效；无需修改全局配置。
缺点：仅覆盖通过DRF序列化器执行的创建/更新操作，视图中直接调用模型save()的情况不会被处理。

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