使用nestjs-joi做NestJS请求验证时如何拆分多个错误为单独对象返回

你不需要完全重写校验逻辑，Joi本身会输出结构化的错误详情，但是nestjs-joi默认将错误合并为单条字符串消息，你只需要自定义校验管道的异常工厂即可实现你要的返回格式，无需额外编写全局错误处理器也可以完成。

核心原理 #

Joi校验失败后返回的ValidationError对象包含details数组，每个元素对应单个字段的校验错误，包含字段路径、错误信息、错误类型等结构化属性，这是你组装目标返回格式的数据源。

实现步骤 #

1. 自定义校验管道的异常工厂

在项目启动文件main.ts中注册全局的JoiValidationPipe时，传入exceptionFactory配置项，直接将Joi返回的错误详情数组组装为你需要的格式：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { JoiValidationPipe } from 'nestjs-joi';
import { BadRequestException } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new JoiValidationPipe({
    exceptionFactory: (validationErrors) => {
      const formattedErrors = validationErrors.map(err => {
        const fieldName = err.path[0];
        return {
          statusCode: 400,
          message: `Request validation of body failed, because: ${err.message}`,
          error: 'Bad Request',
          [fieldName]: err.message
        }
      });
      throw new BadRequestException(formattedErrors);
    }
  }));
  await app.listen(3000);
}
bootstrap();

如果你使用的是局部管道而非全局管道，也可以在控制器参数中单独传入配置：

@Post()
create(@Body(new JoiValidationPipe({ exceptionFactory: 你自定义的异常工厂函数 })) createData: UserDto): string {
  // 业务逻辑
}

2. 可选：自定义字段错误提示

如果需要替换Joi默认的错误提示，可以在定义Dto校验规则时通过messages方法配置对应错误类型的提示文案：

@JoiSchema([CREATE], Joi.string()
  .email({ minDomainSegments: 2 })
  .required()
  .messages({
    'string.email': 'Email must be a valid email',
    'any.required': 'Email is required'
  })
)
email: string;

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