NestJS如何强制Body参数取值仅匹配TypeScript自定义类型允许的范围

TypeScript 的类型系统仅在编译阶段生效，运行时所有类型都会被擦除，你定义的Gender联合类型不会保留任何运行时可判断的信息，所以NestJS默认无法直接基于TS类型做参数校验，这就是为什么非法值"Unknown"会被透传到控制器的原因。

不需要改用枚举，你可以通过「常量数组推导类型 + class-validator校验装饰器」的方式实现需求，步骤如下：

1. 先确认你已经安装了依赖并开启了全局校验管道
   • 安装依赖：npm install class-validator class-transformer
   • 在main.ts中开启全局校验管道：

   import { ValidationPipe } from '@nestjs/common';
   
   async function bootstrap() {
     const app = await NestFactory.create(AppModule);
     // 开启全局参数校验
     app.useGlobalPipes(new ValidationPipe());
     await app.listen(3000);
   }
   bootstrap();
   

2. 改造你的类型和DTO定义：

   // 先定义运行时可访问的合法取值常量数组
   const GENDERS = ["Male", "Female"] as const;
   // 从常量数组推导联合类型，和你原有的Gender类型效果完全一致
   type Gender = typeof GENDERS[number];
   
   // DTO中加校验规则
   import { IsIn } from 'class-validator';
   
   export class User {
       // 其他属性省略
       @IsIn(GENDERS, { message: 'gender只能是Male或Female' })
       gender: Gender;
   }
   

改造完成后，如果请求传入的gender不在允许范围内，接口会直接返回400参数错误，不会进入控制器逻辑，完全满足你的需求。

没有办法完全脱离运行时代码、仅靠TS类型声明实现运行时校验，所有TS类型相关的运行时校验本质都需要对应运行时可读取的取值集合作为判断依据。

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