NestJS开发中Dto无法添加@IsNotEmpty()校验器如何解决

常见触发原因 #

• 依赖缺失：NestJS本身没有内置参数校验实现，必须依赖class-validator、class-transformer两个第三方包完成装饰器校验逻辑，初始化项目时如果没勾选校验选项，默认不会安装这两个包，直接使用装饰器自然无法生效
• 导入路径错误：@IsNotEmpty()是class-validator包导出的专属装饰器，容易误从其他第三方库、本地错误路径导入同名方法，导致校验逻辑完全不匹配
• 校验管道未注册：Nest默认不会自动触发DTO校验规则，必须手动挂载全局ValidationPipe，才会在请求进入业务逻辑前自动匹配DTO规则执行校验
• DTO未绑定路由参数：Controller层编写接口时，如果@Body()、@Query()、@Param()等参数装饰器没有关联对应DTO类，框架无法识别需要对该参数执行校验
• TS编译配置错误：tsconfig.json中未开启装饰器相关编译选项，装饰器在编译阶段被抹除，运行时根本无法识别到校验规则

对应解决步骤 #

1. 安装齐校验依赖
   根据当前使用的包管理器执行安装命令，两个包都需要安装为生产依赖：

# npm
npm i class-validator class-transformer
# yarn
yarn add class-validator class-transformer
# pnpm
pnpm add class-validator class-transformer

2. 核对装饰器导入路径
   打开定义校验规则的DTO文件，确认@IsNotEmpty的导入语句为官方指定路径，不要自定义修改导入来源：

import { IsNotEmpty } from 'class-validator';

3. 注册全局校验管道
   打开项目入口文件src/main.ts，在应用启动前挂载全局ValidationPipe，常用生产可用配置可直接参考：

import { NestFactory } from '@nestjs/core';
import { ValidationPipe } from '@nestjs/common';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 全局参数校验配置
  app.useGlobalPipes(new ValidationPipe({
    transform: true, // 自动将请求入参转换为DTO类实例
    whitelist: true, // 自动剥离DTO中未声明的多余字段
    forbidNonWhitelisted: true, // 传入未声明字段时直接返回400错误
  }));
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

4. 检查Controller层参数绑定
   确认对应接口的参数装饰器正确关联了目标DTO类，示例如下：

import { Body, Controller, Post } from '@nestjs/common';
import { CreateUserDto } from './dto/create-user.dto';
import { UserService } from './user.service';

@Controller('user')
export class UserController {
  constructor(private readonly userService: UserService) {}

  @Post('create')
  // 必须给@Body()指定对应DTO类型，否则不会触发该校验规则
  create(@Body() createUserDto: CreateUserDto) {
    return this.userService.create(createUserDto);
  }
}

5. 核对TypeScript编译配置
   打开项目根目录的tsconfig.json，确认compilerOptions下两个装饰器相关配置为开启状态：

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

以上步骤全部操作完成后如果问题仍存在，直接删除node_modules目录和对应包管理器的锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml），重新执行依赖安装命令后重启服务，大部分缓存导致的异常都能直接解决。

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