NestJS中@UsePipes传ValidationPipe类与实例的区别及用法选择

两种写法的本质差异是Pipe实例的创建、管理权归属：

• 传入类引用（@UsePipes(ValidationPipe)）：Nest框架的依赖注入（DI）容器会全权负责Pipe的实例化、依赖注入和生命周期管理，默认以单例模式在全应用复用实例，自动解析Pipe构造函数里声明的所有被Nest管理的依赖项。该写法要求目标Pipe必须被@Injectable()装饰器标记。
• 传入手动实例化对象（@UsePipes(new ValidationPipe())）：实例由开发者在代码编写阶段手动创建，完全绕过Nest DI容器，框架不会为该实例注入任何依赖，实例生命周期随所在的控制器/路由类加载创建，不会参与全局单例复用。

无特殊配置需求的常规场景下，优先选择传入类引用的写法，该写法更贴合Nest的DI设计范式，默认单例模式内存开销更低，后续如果Pipe新增依赖项无需调整装饰器侧的代码。

优先用类引用写法的场景 #

• 使用Pipe默认配置，不需要传入自定义构造参数
• 自定义Pipe依赖其他Nest托管的Provider（比如配置服务、日志服务、数据库连接实例等）
• 控制器级、全局级注册通用Pipe，追求实例复用的性能最优

优先用手动实例化写法的场景 #

• 需要给当前作用域的Pipe传入专属自定义配置，比如单独给某个路由设置校验规则：

@Post('login')
@UsePipes(new ValidationPipe({
  whitelist: true,
  forbidNonWhitelisted: true,
  transform: true,
  skipMissingProperties: false
}))
login(@Body() loginDto: LoginDto) {
  // 路由逻辑
}

• 使用的Pipe未被@Injectable()标记，不属于Nest DI容器托管的类
• 需要给Pipe绑定无法提前在DI容器中配置的、和当前路由强绑定的动态参数
• 临时调试、快速验证Pipe逻辑，不需要走DI流程的场景

注意：手动new出来的Pipe实例无法获取Nest容器中的依赖项，如果你的Pipe逻辑需要注入其他服务，不要用这种写法，否则会出现依赖为undefined的报错。

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