本文旨在阐明 Nest.js 中自定义验证管道是否必须声明为可注入（`@Injectable()`）的疑问。文章将解释何时需要将管道声明为可注入，以及如何在 `UsePipes` 装饰器中使用依赖注入的管道。此外，本文还将纠正一些常见的依赖注入错误用法，帮助开发者更好地理解和使用 Nest.js 的管道机制。
在 Nest.js 中，管道 (Pipes) 用于转换输入数据或验证输入数据。自定义验证管道可以确保进入路由处理程序的数据符合预期的格式和规则。虽然官方文档建议将自定义验证管道标记为 @Injectable()，但并非所有情况都需要这样做。
何时需要将管道声明为可注入？
当你的管道依赖于 Nest.js 的依赖注入系统来获取其他服务或配置时，就需要将管道声明为 @Injectable()。这意味着管道的构造函数需要接收其他服务作为参数，这些服务由 Nest.js 的 IoC 容器自动注入。
例如，如果你的验证管道需要访问数据库服务来验证数据的唯一性，那么你需要将该管道声明为可注入，并在构造函数中注入数据库服务。
示例：可注入的验证管道
import { Injectable, PipeTransform, ArgumentMetadata, Inject } from '@nestjs/common';
import { UserService } from '../user/user.service'; // 假设你有一个 UserService
@Injectable()
export class UniqueEmailValidationPipe implements PipeTransform {
constructor(
@Inject(UserService)
private readonly userService: UserService,
) {}
async transform(value: any, metadata: ArgumentMetadata) {
const email = value.email; // 假设你的请求体包含 email 字段
const user = await this.userService.findUserByEmail(email);
if (user) {
throw new Error('Email already exists');
}
return value;
}
}在这个例子中，UniqueEmailValidationPipe 依赖于 UserService 来检查电子邮件地址是否已存在。因此，它必须被声明为 @Injectable()。
如何在控制器中使用可注入的管道？
要使用可注入的管道，你需要在控制器中将管道类本身传递给 @UsePipes() 装饰器，而不是创建管道的实例。Nest.js 会自动创建管道的实例并注入所需的依赖项。
import { Controller, Post, Body, UsePipes } from '@nestjs/common';
import { UniqueEmailValidationPipe } from './unique-email-validation.pipe';
@Controller('users')
export class UsersController {
@Post()
@UsePipes(UniqueEmailValidationPipe) // 注意这里传递的是类本身
async createUser(@Body() body: any) {
// ...
}
}在这个例子中，@UsePipes(UniqueEmailValidationPipe) 告诉 Nest.js 使用 UniqueEmailValidationPipe 作为验证管道。Nest.js 会自动创建 UniqueEmailValidationPipe 的实例，并注入 UserService。
何时不需要将管道声明为可注入？
如果你的管道不需要依赖注入，即它的构造函数不需要接收任何参数，那么你不需要将它声明为 @Injectable()。你可以在控制器中直接创建管道的实例并将其传递给 @UsePipes() 装饰器。
示例：非可注入的验证管道
import { PipeTransform, ArgumentMetadata } from '@nestjs/common';
export class StringToNumberPipe implements PipeTransform {
transform(value: string, metadata: ArgumentMetadata): number {
return parseInt(value, 10);
}
}在这个例子中，StringToNumberPipe 只是将字符串转换为数字，不需要依赖注入。因此，它不需要被声明为 @Injectable()。
如何在控制器中使用非可注入的管道？
import { Controller, Get, Query, UsePipes } from '@nestjs/common';
import { StringToNumberPipe } from './string-to-number.pipe';
@Controller('items')
export class ItemsController {
@Get()
@UsePipes(new StringToNumberPipe()) // 这里创建了管道的实例
async getItems(@Query('limit') limit: number) {
// ...
}
}在这个例子中，@UsePipes(new StringToNumberPipe()) 创建了 StringToNumberPipe 的实例并将其传递给 @UsePipes() 装饰器。
注意事项和总结
- 只有当你的管道依赖于 Nest.js 的依赖注入系统时，才需要将它声明为 @Injectable()。
- 如果你的管道不需要依赖注入，你可以直接创建管道的实例并将其传递给 @UsePipes() 装饰器。
- 当使用可注入的管道时，将管道类本身传递给 @UsePipes() 装饰器，而不是创建管道的实例。
- 避免在 @UsePipes() 装饰器中使用 this 关键字，因为它在装饰器执行时可能还没有被正确绑定。
理解何时以及如何使用可注入的管道可以帮助你编写更清晰、更可维护的 Nest.js 应用程序。通过遵循这些最佳实践，你可以充分利用 Nest.js 的依赖注入系统，并创建强大的验证管道来确保数据的完整性。
