Django Rest Framework自定义错误格式：提取嵌套校验错误为单一数组

核心思路是通过递归遍历 DRF 返回的嵌套错误结构，逐层提取字段名和对应错误信息，拼接后存入一维数组。

1. 核心递归处理函数 #

from rest_framework.exceptions import ErrorDetail

def flatten_serializer_errors(errors):
    error_list = []
    for key, value in errors.items():
        if isinstance(value, list):
            # 当前层级为字段的错误列表
            for err in value:
                if isinstance(err, ErrorDetail):
                    error_list.append(f"{key} {str(err)}")
        elif isinstance(value, dict):
            # 嵌套结构递归处理
            nested_errors = flatten_serializer_errors(value)
            error_list.extend(nested_errors)
    return error_list

针对你给出的错误结构，该函数会直接返回你需要的格式：

["field_name Must be a valid boolean.", "module_id Must be a valid boolean.", "read A valid integer is required."]

2. 使用方式 #

2.1 单视图手动调用 #

在需要使用该错误格式的视图中，校验序列化器后手动处理错误即可：

from rest_framework.response import Response
from rest_framework.views import APIView

class RoleView(APIView):
    def post(self, request):
        serializer = RoleValidateSerializer(data=request.data)
        if not serializer.is_valid():
            flat_errors = flatten_serializer_errors(serializer.errors)
            return Response({"errors": flat_errors}, status=400)
        # 校验通过后的业务逻辑
        return Response({"msg": "校验通过"})

2.2 全局自动生效 #

如果需要所有序列化器的校验错误都自动使用该格式，可以自定义 DRF 全局异常处理器：

1. 编写异常处理器逻辑

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

def custom_exception_handler(exc, context):
    response = exception_handler(exc, context)
    if response is not None and isinstance(exc, ValidationError):
        # 替换默认错误结构为拉平数组
        flat_errors = flatten_serializer_errors(exc.detail)
        response.data = {"errors": flat_errors}
    return response

2. 在 settings.py 中配置 DRF 异常处理器

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': '你的应用名.对应文件路径.custom_exception_handler'
}

3. 扩展：保留完整错误路径 #

如果需要明确错误所在的层级位置（比如多组模块数据同时报错时区分错误所属条目），可以使用带路径拼接的递归函数：

def flatten_serializer_errors(errors, parent_path=""):
    error_list = []
    for key, value in errors.items():
        # 拼接当前字段完整路径
        if parent_path:
            if key.isdigit():
                current_path = f"{parent_path}[{key}]"
            else:
                current_path = f"{parent_path}.{key}"
        else:
            current_path = key
        if isinstance(value, list):
            for err in value:
                if isinstance(err, ErrorDetail):
                    error_list.append(f"{current_path} {str(err)}")
        elif isinstance(value, dict):
            nested_errors = flatten_serializer_errors(value, current_path)
            error_list.extend(nested_errors)
    return error_list

该版本返回的错误格式如下：

["field_name Must be a valid boolean.", "modules[0].module_id Must be a valid boolean.", "modules[0].read A valid integer is required."]

补充说明 #

你当前触发的校验错误是因为序列化器字段类型定义和实际传入数据类型不匹配：

• field_name 实际传入字符串类型，但定义为 BooleanField
• module_id 实际传入字符串类型，但定义为 BooleanField
• read 实际传入布尔类型，但定义为 IntegerField
  调整对应字段类型即可解决上述校验错误，上述错误格式处理逻辑不影响正常校验规则。

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