在NestJS中能否用class-validator验证顶层数组？

你完全不需要扩展ValidationPipe转换请求体格式，class-validator结合NestJS的内置管道就能直接验证顶层数组，只是写法上和嵌套数组略有不同。

具体实现步骤 #

1. 定义单个项的DTO
   先为数组中的每个元素定义验证规则：

   import { IsNumber, IsString } from 'class-validator';
   
   export class UserDto {
     @IsNumber()
     id: number;
   
     @IsString()
     name: string;
   }
   

2. 在控制器中使用ParseArrayPipe
   在路由处理函数的@Body()装饰器中传入ParseArrayPipe，指定数组项的类型，全局的ValidationPipe会配合它完成每个元素的验证：

   import { Controller, Post, Body, ParseArrayPipe } from '@nestjs/common';
   import { UserDto } from './user.dto';
   
   @Controller('users')
   export class UsersController {
     @Post()
     createUsers(
       @Body(new ParseArrayPipe({ 
         items: UserDto,
         whitelist: true, // 可复用全局ValidationPipe的配置，比如自动移除未定义字段
         transform: true // 自动将原始数据转换为DTO实例
       })) users: UserDto[],
     ) {
       return users;
     }
   }
   

为什么文档侧重嵌套数组？ #

文档里提到的嵌套数组验证，是针对请求体为对象、数组作为对象属性的场景，这种情况可以直接在父DTO中通过@IsArray()、@ValidateNested({ each: true })和@Type(() => UserDto)来定义规则。而顶层数组的场景因为请求体本身就是数组，无法用普通DTO包裹，所以需要借助ParseArrayPipe来告知NestJS数组的元素类型，进而触发class-validator的验证逻辑。

简单来说，class-validator并没有缺失顶层数组验证的能力，只是需要结合NestJS的ParseArrayPipe来适配顶层数组的请求体结构，这部分属于NestJS管道的组合用法，文档可能没有单独突出，但确实是官方支持的方案。

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