如何用drf-standardized-errors与drf-spectacular为APIView的validation_error生成文档？

可以实现，核心是通过@extend_schema显式声明400响应的结构——因为手动参数验证的逻辑不会被drf-spectacular自动识别，而ViewSet能自动生成是因为其内置流程被框架钩子处理了。

具体实现步骤： #

1. 导入所需工具类：

from drf_spectacular.utils import extend_schema, OpenApiResponse
from drf_spectacular.serializers import ValidationErrorSerializer

2. 在你的APIView类上，通过@extend_schema的responses参数，明确指定400响应使用ValidationErrorSerializer，同时保留原有的200响应配置：

class YourCalculationAPI(APIView):
    @extend_schema(
        parameters=[
            # 这里填写你已配置的GET参数文档
        ],
        responses={
            200: YourResultSerializer,
            400: OpenApiResponse(
                response=ValidationErrorSerializer,
                description="参数验证失败，返回标准化的validation_error结构"
            )
        }
    )
    def get(self, request):
        # 你的手动参数验证逻辑
        serializer = YourParamSerializer(data=request.query_params)
        if not serializer.is_valid():
            return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
        # 计算逻辑...
        return Response(result, status=status.HTTP_200_OK)

为什么之前的方法无效？ #

• 使用GenericAPIView并声明serializer_class时，该序列化器默认只会关联到200响应的文档生成，不会自动绑定到400的验证错误响应。
• drf-spectacular无法自动识别你手动调用序列化器验证的逻辑，必须显式告知框架这个400响应的结构是validation_error类型。

这样配置后，接口文档里的400响应就会展示和ViewSet一致的validation_error结构，包含字段级错误等细节。

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