NestJS中Class Validator验证失效问题求助

问题描述 #

多个基于NestJS的项目里，之前正常用的Class Validator参数校验突然失效了，DTO里的校验逻辑完全不执行。相关代码和依赖版本如下：

控制器代码 #

@Post()
async create(@Body() body: UserDTO) {
  return body;
}

DTO代码 #

import { IsNotEmpty, IsString } from 'class-validator';

export class UserDTO {
  @IsNotEmpty()
  @IsString()
  name: string;
}

main.ts配置 #

app.useGlobalPipes(
    new ValidationPipe({
      whitelist: true,
      forbidNonWhitelisted: true,
      transform: true,
    }),
  );

依赖版本 #

"class-transformer": "^0.5.1",
"class-validator": "^0.13.2",

排查与解决方法 #

1. 先查依赖兼容性 #

Class Validator 0.13.x和Class Transformer 0.5.x跟部分NestJS版本可能存在兼容性问题，直接升级到最新版试试：

npm install class-validator@latest class-transformer@latest

2. 确认ValidationPipe的注册时机 #

得保证全局管道是在app.listen()之前注册的，别被其他中间件覆盖了。如果是在模块内注册的管道，也要检查模块的导入顺序是否正确。

3. 检查TS配置项 #

tsconfig.json里必须开启这两个配置，不然装饰器没法正常工作：

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

4. 简化配置做基础测试 #

先把ValidationPipe的配置简化，排除多余参数的干扰：

app.useGlobalPipes(new ValidationPipe());

然后发个测试请求（比如POST请求不带name字段），看看会不会返回校验错误。如果这时候正常了，再逐步加回原来的配置项排查问题。

5. 核对DTO的导入和使用 #

检查控制器里是不是正确导入了UserDTO，别因为路径写错或者用了错误的类型别名，导致NestJS识别不到DTO的校验装饰器。

6. 清缓存重装依赖试试 #

有时候缓存或者依赖损坏也会出问题：

• 删除node_modules和package-lock.json（用yarn的话删yarn.lock）
• 重新执行npm install
• 重启项目，顺便清除编译缓存

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