NestJS通过内置依赖注入(DI)系统实现控制反转,使用@Injectable()标记服务并在构造函数中注入,需在@Module的providers中注册,支持useClass、useFactory、useValue等自定义提供者配置,提升代码解耦与可测试性。

NestJS 是一个基于 Node.js 的渐进式框架,深受 Angular 启发。它原生支持依赖注入(Dependency Injection, DI),这让服务之间的解耦更加清晰,代码更易于测试和维护。理解 NestJS 中的依赖注入机制,是掌握其架构设计的关键一步。
什么是依赖注入
依赖注入是一种设计模式,用于实现控制反转(IoC)。它的核心思想是:类不主动创建依赖对象,而是由外部容器将依赖“注入”进来。这样可以降低模块间的耦合度,提升可复用性和可测试性。
在 NestJS 中,内置了一个强大的依赖注入系统,开发者可以通过装饰器轻松定义和使用服务。
@Injectable() 装饰器
要在 NestJS 中使用依赖注入,首先需要将服务标记为可注入的。这通过 @Injectable() 装饰器实现。
立即学习“Java免费学习笔记(深入)”;
注意:即使某个服务没有显式依赖其他服务,只要你想通过 DI 容器管理它,就必须加上 @Injectable()。示例:
@Injectable()
export class UserService {
getUsers() {
return ['Alice', 'Bob'];
}
}
这个服务现在可以被其他组件(如控制器或其他服务)注入使用。
在控制器中注入服务
控制器通过构造函数参数自动注入服务。NestJS 会根据类型解析对应的提供者。
示例:
@Controller('users')
export class UserController {
constructor(private readonly userService: UserService) {}
@Get()
findAll() {
return this.userService.getUsers();
}
}
这里,private readonly userService: UserService 语法在构造函数中声明并初始化属性,NestJS 会自动查找注册的 UserService 实例并注入。
提供者(Providers)与模块注册
要让依赖注入工作,服务必须在模块中作为提供者注册。
mallcloud商城基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba并采用前后端分离vue的企业级微服务敏捷开发系统架构。并引入组件化的思想实现高内聚低耦合,项目代码简洁注释丰富上手容易,适合学习和企业中使用。真正实现了基于RBAC、jwt和oauth2的无状态统一权限认证的解决方案,面向互联网设计同时适合B端和C端用户,支持CI/CD多环境部署,并提
示例模块:
@Module({
controllers: [UserController],
providers: [UserService],
})
export class UserModule {}
NestJS 的 DI 容器会在模块范围内查找提供者。如果多个模块需要同一个服务,可以将其设为全局服务或通过导出/导入共享。
若想在多个模块共用 UserService,可在原模块中导出:
@Module({
providers: [UserService],
exports: [UserService],
})
export class UserModule {}
然后在其他模块中导入 UserModule 即可使用 UserService。
自定义提供者与复杂注入场景
NestJS 支持更灵活的提供者配置,比如使用 useValue、useFactory 或 useClass。
- useClass:指定依赖的具体类
- useValue:注入常量或模拟对象(适合测试)
- useFactory:动态生成实例,支持异步逻辑
示例:使用工厂函数创建服务
@Module({
providers: [
{
provide: 'CONFIG',
useFactory: () => {
return process.env.NODE_ENV === 'development'
? { debug: true }
: { debug: false };
},
},
],
})
export class AppModule {}
之后可通过 @Inject('CONFIG') 注入该值。
总结
NestJS 的依赖注入系统让应用结构更清晰。关键点包括:
- 使用 @Injectable() 标记服务
- 通过构造函数注入依赖
- 在 @Module 中注册 providers
- 支持 useClass、useFactory、useValue 等高级用法
基本上就这些,掌握后能更高效地组织业务逻辑和服务调用。









