如何在NestJS中用class-validator和class-transformer验证嵌套纯对象的子DTO

我研究这个问题很久了，核心矛盾出在NestJS默认验证管道的执行逻辑：先验证，后转换。

• REST接口传入的是原始JSON对象，@ValidateNested()仅能验证已实例化的DTO类对象，对未转换的原始JSON完全不起作用
• @Type()和@Transform()属于转换流程，默认在验证完成后才执行，根本赶不上给验证环节提供可用的DTO实例
• 很多开发者踩坑都是因为没区分「验证」和「转换」是两个独立流程，顺序搞反自然解决不了问题

现成解决方案：先转换后验证的自定义管道 #

不用从零搭建验证逻辑，直接基于class-transformer和class-validator实现一个先转换再验证的管道即可：

import { PipeTransform, Injectable, ArgumentMetadata, BadRequestException } from '@nestjs/common';
import { plainToInstance } from 'class-transformer';
import { validate } from 'class-validator';

@Injectable()
export class TransformAndValidatePipe implements PipeTransform<any> {
  async transform(value: any, { metatype }: ArgumentMetadata) {
    // 基础类型无需转换验证
    if (!metatype || ['String', 'Boolean', 'Number', 'Array', 'Object'].includes(metatype.name)) {
      return value;
    }
    // 第一步：将原始JSON转换为DTO实例
    const dtoInstance = plainToInstance(metatype, value);
    // 第二步：对实例执行验证
    const validationErrors = await validate(dtoInstance);
    if (validationErrors.length > 0) {
      throw new BadRequestException('参数验证失败');
    }
    return dtoInstance;
  }
}

在main.ts中全局注册该管道，就能全局生效：

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new TransformAndValidatePipe());
  await app.listen(3000);
}
bootstrap();

这样所有接口参数都会先被转换成对应DTO实例，再执行验证，@ValidateNested()就能正常工作了。

自定义验证器的备选思路 #

如果需要针对特定嵌套结构做定制化验证，可以编写自定义验证器，核心逻辑仍是在验证前手动将JSON转换为DTO：

import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments, validate } from 'class-validator';
import { plainToInstance } from 'class-transformer';

@ValidatorConstraint({ name: 'validateNestedDto', async: true })
export class ValidateNestedDto implements ValidatorConstraintInterface {
  async validate(rawValue: any, args: ValidationArguments) {
    const [NestedDtoClass] = args.constraints;
    const dtoInstance = plainToInstance(NestedDtoClass, rawValue);
    const errors = await validate(dtoInstance);
    return errors.length === 0;
  }

  defaultMessage() {
    return '嵌套参数格式不正确';
  }
}

在目标DTO中使用该验证器：

import { Validate } from 'class-validator';
import { ValidateNestedDto } from './validate-nested-dto.validator';
import { UserProfileDto } from './user-profile.dto';

export class CreateUserDto {
  @Validate(ValidateNestedDto, [UserProfileDto])
  profile: UserProfileDto;
}

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