NestJS中仅作为类型声明的DTO如何实现运行时验证？

问题描述 #

首次接触NestJS与class-validators库时遇到疑问：明明TypeScript类型仅存在于编译阶段，为何仅通过如下DTO类和控制器代码，就能实现请求体的运行时验证？

示例DTO：

export class LoginDto {
  @IsEmail()
  email: string;

  @IsString()
  password: string;
}

NestJS控制器代码：

@Post('login')
login(@Body() body: LoginDto) {
  return this.authService.login(body);
}

核心疑问：TypeScript类型编译后会被擦除，为何请求体仍能基于该DTO实现运行时验证？

解答 #

你这里的关键误解是：LoginDto不是TypeScript的类型声明（比如interface或type），而是一个标准的ES6类，类在编译后会保留为JavaScript构造函数，不会被擦除。验证逻辑能运行的核心在于以下两点：

1. 装饰器注入验证元数据
   @IsEmail()、@IsString()这些是class-validator提供的装饰器，它们的作用是在类的**元数据（Metadata）**中添加对应的验证规则。TypeScript编译时会将装饰器转化为可执行的JavaScript代码，把验证规则附加到LoginDto类的属性上，这些元数据在运行时是可以被读取的。

2. NestJS的ValidationPipe自动处理验证流程
   NestJS的ValidationPipe（需在模块中配置或全局启用）会拦截进入控制器的请求：

• 先将请求体数据实例化为LoginDto类的对象（这也是必须用类而非interface的原因——interface编译后不存在，无法实例化）；
• 再读取之前通过装饰器注入的元数据，调用class-validator执行验证逻辑；
• 若验证不通过，会自动返回错误响应，不会进入控制器方法。

至于你在@Body()里写的body: LoginDto，这只是TypeScript的类型标注，仅用于开发阶段的类型检查，运行时真正起作用的是LoginDto类本身和装饰器附加的验证元数据。

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