如何解决DRF ValidationError响应将布尔值转为字符串的问题

DRF 默认的异常处理逻辑在处理 ValidationError 时，会递归遍历传入的 detail 内容，将所有非字典、非列表、非字符串类型的值强制调用 str() 转为字符串，布尔值 True/False 会被直接转成 "True"/"False" 字符串，最终序列化到JSON响应里就是字符串格式。

通过自定义全局异常处理，覆盖默认的类型转换逻辑，保留布尔值的原生类型即可，步骤如下：

1. 编写自定义异常处理函数
   在项目任意可导入的路径下（例如常用的 utils/exceptions.py）新增如下代码：

from rest_framework.views import exception_handler
from rest_framework.exceptions import ValidationError


def custom_exception_handler(exc, context):
    # 先执行DRF原生异常处理，获取基础响应对象
    response = exception_handler(exc, context)

    # 仅针对ValidationError类型做自定义处理
    if response is not None and isinstance(exc, ValidationError):
        def format_detail(data):
            # 递归处理字典结构
            if isinstance(data, dict):
                return {key: format_detail(value) for key, value in data.items()}
            # 递归处理列表结构
            if isinstance(data, list):
                return [format_detail(item) for item in data]
            # 布尔值直接返回原生类型，不做字符串转换
            if isinstance(data, bool):
                return data
            # 其余类型保持DRF原有转换逻辑
            return data if isinstance(data, (str, dict, list)) else str(data)
        
        response.data = format_detail(exc.detail)
    
    return response

2. 注册自定义异常处理
   打开项目的 settings.py，找到 REST_FRAMEWORK 配置块，新增异常处理路径配置：

REST_FRAMEWORK = {
    # 你已有的其他DRF配置...
    "EXCEPTION_HANDLER": "你的模块路径.custom_exception_handler"
    # 举例：如果函数放在myapp目录下的utils/exceptions.py中，路径填"myapp.utils.exceptions.custom_exception_handler"
}

配置完成后，再执行如下抛出异常的代码：

raise ValidationError(detail={"something": True})

接口将返回符合预期的原生布尔值格式：

{
    "something": true
}

提示：上述处理函数兼容嵌套字典、列表结构的校验错误信息，嵌套层级中的布尔值也会被正确保留，不会被转为字符串。

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