#懒加载模块

默认情况下，模块采用急切加载方式，这意味着应用一旦启动就会加载所有模块，无论它们是否立即需要。虽然这对大多数应用来说没有问题，但对于运行在无服务器环境中的应用/工作器可能成为瓶颈，其中启动延迟（"冷启动"）至关重要。

懒加载可以通过仅加载特定无服务器函数调用所需的模块来减少引导时间。此外，一旦无服务器函数"预热"后，您还可以异步加载其他模块，从而进一步加快后续调用的引导时间（延迟模块注册）。

#入门指南

为了实现按需加载模块，Nest 提供了 LazyModuleLoader 类，可以通过常规方式注入到类中：

@Injectable()
export class CatsService {
 constructor(private lazyModuleLoader: LazyModuleLoader) {}
}

或者，你也可以从应用程序引导文件(main.ts)中获取 LazyModuleLoader 提供者的引用，如下所示：

// "app" 代表 Nest 应用实例
const lazyModuleLoader = app.get(LazyModuleLoader);

这样配置后，您现在可以使用以下结构加载任何模块：

const { LazyModule } = await import('./lazy.module');
const moduleRef = await this.lazyModuleLoader.load(() => LazyModule);

Load "LazyModule" attempt: 1
time: 2.379ms
Load "LazyModule" attempt: 2
time: 0.294ms
Load "LazyModule" attempt: 3
time: 0.303ms

此外，"懒加载"模块与应用启动时急切加载的模块以及后续在应用中注册的其他懒加载模块共享相同的模块关系图。

其中 lazy.module.ts 是一个导出常规 Nest 模块的 TypeScript 文件（无需额外修改）。

LazyModuleLoader#load 方法返回一个模块引用 （属于 LazyModule 类型），该引用允许您遍历内部提供者列表，并使用注入令牌作为查找键获取任意提供者的引用。

例如，假设我们有一个 LazyModule 包含以下定义：

@Module({
  providers: [LazyService],
  exports: [LazyService],
})
export class LazyModule {}

通过这种方式，我们可以获取 LazyService 提供者的引用，如下所示：

const { LazyModule } = await import('./lazy.module');
const moduleRef = await this.lazyModuleLoader.load(() => LazyModule);

const { LazyService } = await import('./lazy.service');
const lazyService = moduleRef.get(LazyService);

{
  "compilerOptions": {
    "module": "esnext",
    "moduleResolution": "node",
    ...
  }
}

设置这些选项后，您就能利用代码分割功能。

#懒加载控制器、网关和解析器

由于 Nest 中的控制器（或 GraphQL 应用中的解析器）代表路由/路径/主题集（或查询/变更），您无法通过 LazyModuleLoader 类实现懒加载。

例如，假设你正在构建一个底层使用 Fastify 驱动（通过 @nestjs/platform-fastify 包）的 REST API（HTTP 应用）。Fastify 不允许在应用准备就绪/成功监听消息后注册路由。这意味着即使我们分析了模块控制器中注册的路由映射，所有懒加载路由也无法访问，因为在运行时无法注册它们。

同样，我们作为 @nestjs/microservices 包一部分提供的某些传输策略（包括 Kafka、gRPC 或 RabbitMQ）需要在建立连接前订阅/监听特定主题/通道。一旦你的应用开始监听消息，框架将无法订阅/监听新的主题。

最后，启用了代码优先方法的 @nestjs/graphql 包会根据元数据动态自动生成 GraphQL 模式。这意味着它需要预先加载所有类，否则无法创建正确有效的模式。

#常见用例

最常见的情况是，当你的工作进程/定时任务/lambda 及无服务器函数/webhook 需要根据输入参数（路由路径/日期/查询参数等）触发不同服务（不同逻辑）时，你会看到延迟加载模块的使用。另一方面，对于单体应用来说，启动时间并不那么重要，延迟加载模块可能没有太大意义。