在Django Rest Framework中收集并返回错误列表的实现方案

以下是几种在Django Rest Framework中批量收集验证错误并统一返回的可行方案，全程不会触发数据库或媒体操作：

通过重写DRF的异常处理逻辑，统一捕获各类验证/权限异常，将其整理为结构化的错误列表返回。

代码示例：
首先在项目中创建utils/exceptions.py：

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

def custom_exception_handler(exc, context):
    # 先调用DRF默认的异常处理器获取基础响应
    response = exception_handler(exc, context)
    
    errors = []
    if response is not None:
        # 处理序列化器ValidationError（可能是字段错误或自定义错误）
        if isinstance(exc, ValidationError):
            # 扁平化DRF默认的嵌套错误结构
            for field, messages in response.data.items():
                if isinstance(messages, list):
                    errors.extend([f"{field}: {msg}" for msg in messages])
                else:
                    errors.append(f"{field}: {messages}")
        # 处理权限错误
        elif isinstance(exc, PermissionDenied):
            errors.append(str(exc))
        # 其他类型的异常可按需扩展
        else:
            errors.append(str(exc))
        
        # 重构响应数据为错误列表格式
        response.data = {"errors": errors}
        response.status_code = status.HTTP_400_BAD_REQUEST
    return response

然后在settings.py中配置：

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'utils.exceptions.custom_exception_handler',
}

在序列化器中自定义validate方法，不中途抛出异常，而是收集所有验证失败的信息，最后统一抛出ValidationError。

代码示例：

from rest_framework import serializers
from .models import YourModel

class YourModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = YourModel
        fields = '__all__'
    
    def validate(self, attrs):
        errors = []
        user = self.context['request'].user
        
        # 1. 验证用户权限
        if not user.has_perm('your_app.add_yourmodel'):
            errors.append("当前用户无权限创建该内容")
        
        # 2. 验证名称是否已存在（仅查询不写入，无数据库修改操作）
        name = attrs.get('name')
        if YourModel.objects.filter(name=name).exists():
            errors.append(f"名称「{name}」已存在")
        
        # 3. 调用父类的validate方法，收集字段级错误
        try:
            super().validate(attrs)
        except serializers.ValidationError as e:
            # 合并字段错误到errors列表
            for field, messages in e.detail.items():
                errors.extend([f"{field}: {msg}" for msg in messages])
        
        # 若有错误则统一抛出
        if errors:
            raise serializers.ValidationError(errors)
        
        return attrs

在视图的业务逻辑执行前，完成所有验证步骤，收集错误后直接返回响应，避免触发后续的数据库操作。

代码示例：

from rest_framework import status
from rest_framework.response import Response
from rest_framework.views import APIView
from .serializers import YourModelSerializer
from .models import YourModel

class YourModelCreateView(APIView):
    def post(self, request):
        errors = []
        user = request.user
        
        # 1. 权限验证
        if not user.has_perm('your_app.add_yourmodel'):
            errors.append("当前用户无权限创建该内容")
        
        # 2. 名称重复验证
        name = request.data.get('name')
        if name and YourModel.objects.filter(name=name).exists():
            errors.append(f"名称「{name}」已存在")
        
        # 3. 序列化器验证（不自动抛出异常）
        serializer = YourModelSerializer(data=request.data, context={'request': request})
        if not serializer.is_valid():
            # 扁平化序列化器错误
            for field, messages in serializer.errors.items():
                errors.extend([f"{field}: {msg}" for msg in messages])
        
        # 若有错误，直接返回错误列表
        if errors:
            return Response({"errors": errors}, status=status.HTTP_400_BAD_REQUEST)
        
        # 所有验证通过后再执行后续逻辑（如果需要）
        # 注意：此处若要避免数据库操作，可省略save步骤，仅返回成功响应
        return Response({"message": "验证通过"}, status=status.HTTP_200_OK)

• 所有验证逻辑必须在调用serializer.save()或任何数据库写入操作之前执行，确保不会产生数据修改。
• 对于需要查询数据库的验证（如名称重复），仅使用exists()或filter()等只读操作，避免触发写入。
• 统一错误格式便于前端解析，建议返回{"errors": ["错误信息1", "错误信息2"]}的结构。

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