当前位置：首页 > news >正文

【NestJS】依赖注入（DI）的模块系统、`imports`、`@Module`、`providers` 之间的关系彻底搞清楚

news 2025/10/25 13:43:19

1️⃣ `@Module()` 的作用

在 NestJS 中，模块 (Module) 是组织代码的基本单位。它有四大核心属性：

属性	作用
`providers`	定义当前模块提供的服务（可以被注入的类、值、工厂等）
`controllers`	定义当前模块的控制器（接收请求、调用服务）
`imports`	导入其他模块，使得它们导出的 providers 可被当前模块使用
`exports`	将当前模块中的 providers 暴露给被导入模块使用

简单理解：

模块 = 容器，负责收集 provider、控制器、导入的依赖。
每个模块内部的 provider 默认只能在模块内部使用，除非用 exports 暴露。
模块之间通过 imports 和 exports 建立依赖关系。

2️⃣ `providers` 的作用

providers 就是 模块可注入对象的清单。

支持的类型：

类（最常用）：

@Injectable()
export class UserService {}

在模块中注册：

@Module({providers: [UserService],
})
export class UserModule {}

值（useValue）：

@Module({providers: [{ provide: 'API_KEY', useValue: '123456' },],
})

工厂函数（useFactory）：

@Module({providers: [{provide: DatabaseService,useFactory: () => new DatabaseService(process.env.DB_URL),},],
})

替代实现（useClass）：

@Module({providers: [{ provide: Logger, useClass: FileLogger },],
})

所有 provider 最终都会注册到模块的 IoC 容器 中，供构造函数注入使用。

3️⃣ `imports` 的作用

imports 是 模块间依赖的桥梁。

当一个模块需要使用其他模块的 provider 时，就要通过 imports 导入那个模块。
被导入模块必须通过 exports 将需要共享的 provider 暴露。

示例：

// database.module.ts
@Module({providers: [DatabaseService],exports: [DatabaseService], // 暴露给其他模块
})
export class DatabaseModule {}// user.module.ts
@Module({imports: [DatabaseModule], // 导入 DatabaseModuleproviders: [UserService], // UserService 依赖 DatabaseService
})
export class UserModule {}

Nest 启动时，容器会：

加载 UserModule；
发现它导入了 DatabaseModule；
从 DatabaseModule.exports 中注册 DatabaseService；
UserService 的构造函数依赖 DatabaseService，容器自动注入。

总结：imports + exports = 模块间依赖共享机制。

4️⃣ provider 和模块的关联

关系可理解为：

@Module({imports: [...],     // 导入模块，获取它们 exports 的 providersproviders: [...],   // 当前模块自己的 providerscontrollers: [...], // 当前模块控制器exports: [...]      // 将当前模块的 providers 暴露给其他模块
})

依赖注入流程：