NestJS使用ValidationPipe校验数组内容时失效该如何解决？

问题原因 #

嵌套数组校验不生效的核心原因是class-validator默认不会校验普通JS对象类型的嵌套属性，需要显式指定嵌套校验规则，同时需要将数组内的元素转换为对应DTO的类实例才能触发内部的校验规则。

解决步骤 #

1. 确认基础依赖

确保项目已安装两个核心依赖：

npm install class-validator class-transformer

2. 修改create-user.dto.ts配置

首先导入需要的装饰器，然后给addresses字段添加校验规则：

import { IsOptional, IsArray, ValidateNested } from 'class-validator';
import { Type } from 'class-transformer';
import { CreateUserAddressDto } from './create-user-address.dto'; // 替换为你实际的文件路径

export class CreateUserDto {
    @IsNotEmpty({ message: 'ERROR_REQUIRED_FULL_NAME' })
    fullName?: string;

    @IsNotEmpty({ message: 'ERROR_REQUIRED_PASSWORD' })
    password?: string;

    @IsNotEmpty({ message: 'ERROR_REQUIRED_EMAIL' })
    @IsEmail({}, { message: 'ERROR_INVALID_EMAIL' })
    email?: string;

    // 修改后的addresses字段配置
    @IsOptional() // 允许不传地址，匹配0个地址的需求
    @IsArray() // 确保传值时一定是数组格式
    @ValidateNested({ each: true }) // 校验数组内的每一个元素
    @Type(() => CreateUserAddressDto) // 将数组元素转换为对应DTO实例
    addresses?: CreateUserAddressDto[];
}

3. 开启ValidationPipe的转换功能

需要给校验管道开启transform配置，才能让@Type装饰器正常完成对象实例化：

• 如果是全局注册管道，修改main.ts：

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    transform: true, // 必须开启
    whitelist: true, // 可选，自动剔除DTO未声明的字段
  }));
  await app.listen(3000);
}
bootstrap();

• 如果是仅在当前控制器使用，修改控制器的管道配置：

@Post()
@UsePipes(new ValidationPipe({ transform: true }))
async createUser(
    @Body() createUser: CreateUserDto,
) {
    return await this.service.saveUserAndAddress(createUser);
}

规则说明 #

修改完成后完全匹配你的业务需求：

• 用户不传addresses字段时，不会触发任何地址相关校验
• 用户传入addresses数组时，数组内每个元素都会自动触发CreateUserAddressDto中定义的所有校验规则

内容的提问来源于stack exchange，提问作者Bráulio Figueiredo