考察点:模块复用、异步配置、DI 与配置解耦。属于框架进阶必会。
要点:
ConfigService、环境变量、密钥管理),而且要在应用启动时异步建立连接。动态模块让「模块在导入时才决定自己的 providers」,从而把配置注入到库模块。 - forRoot(options):配置已知,直接传(如 TypeOrmModule.forRoot({ type:'postgres', ... }));
- forRootAsync({ imports, inject, useFactory }):配置需要异步获取(读 ConfigService、拉远端配置、初始化连接池后再决定)。
@Module({})
export class DbModule {
static forRootAsync(): DynamicModule {
return {
module: DbModule,
imports: [ConfigModule],
providers: [{
provide: 'DB',
inject: [ConfigService],
useFactory: async (cfg: ConfigService) => createPool({ url: cfg.get('DB_URL') }),
}],
exports: ['DB'],
global: true,
}
}
}
- useFactory 可以是 async,容器会等待它 resolve 再继续启动 —— 这是「启动前完成初始化」的正道,比在 onModuleInit 里连库更可控;
- 动态模块返回的是新的模块定义,所以每次 forRootAsync() 调用语义上都是一次配置;
- global: true 让主模块只需 import 一次,子模块无需重复引入(数据库、配置、日志这类「基础设施模块」适合);
- forFeature() 与之配套:forRoot 建连接、forFeature([Entity]) 在业务模块里注册 Entity 对应的 Repository。
useFactory 或用 validationSchema(joi/zod)——启动时就报错永远优于运行时才发现配置缺失;敏感值走 @nestjs/config 的 expandVariables 或密钥管理服务,不落代码库。ConfigModule.forRoot({ isGlobal: true, cache: true });Nest 10+ 支持 useFactory 返回 AsyncLocalStorage 做请求级上下文传递。题目与答案就在本页;收藏、批注和错题重练在应用内