DRF自定义Exception Handler未触发，需ValidationError返回JSON响应

开发者阿泽

2026-7-10

解决DRF自定义异常处理器未触发ValidationError的问题

可能的原因及解决方案

1. 未正确导入DRF默认的`exception_handler`

你的自定义处理器中调用了exception_handler(exc, context)，但如果没有从DRF导入该函数，会导致调用失败，处理器无法正常执行。

修正代码：
在exception_handler.py顶部添加正确的导入：

from rest_framework.views import exception_handler
from rest_framework.exceptions import ValidationError
from rest_framework.response import Response
from rest_framework import status

2. 使用了Django原生的`ValidationError`而非DRF版本

DRF的异常处理器仅默认捕获自身定义的异常类，若你在序列化器中导入的是Django原生的ValidationError，处理器不会触发。

修正代码：
将序列化器中的导入替换为DRF版本：

# 替换之前的导入（若有）
# from django.core.exceptions import ValidationError
from rest_framework.exceptions import ValidationError

3. 自定义处理器未针对`ValidationError`添加处理逻辑

默认的exception_handler会为ValidationError生成基础响应，但如果你的处理器未对其进行自定义处理或未返回响应，可能导致你误以为未触发。

完整的自定义处理器示例：

def handler(exc, context):
    # 先调用DRF默认处理器获取基础响应
    response = exception_handler(exc, context)

    # 针对ValidationError生成自定义JSON响应
    if isinstance(exc, ValidationError):
        return Response(
            {
                "code": status.HTTP_400_BAD_REQUEST,
                "message": "参数验证失败",
                "errors": exc.detail
            },
            status=status.HTTP_400_BAD_REQUEST
        )

    # 其他异常沿用默认处理或继续自定义
    return response