NestJS部署Firebase Functions冷启动未初始化即报错求助

问题原因 #

Firebase Functions的HTTP触发器会在请求处理函数返回后立即终止执行。而NestJS应用的初始化是异步操作（包含模块加载、依赖注入初始化等步骤），如果直接在函数中启动Nest却不等待初始化完成就返回，函数进程会在"Nest Ready"日志输出前结束，导致请求收到错误响应。热启动时实例已缓存，所以请求能正常处理。

解决方案 #

1. 缓存Nest应用实例，确保初始化完成后再处理请求

通过异步函数提前完成Nest应用的初始化，并缓存实例避免重复初始化，保证每次请求都能在Nest准备就绪后被处理：

import { NestFactory } from '@nestjs/core';
import { ExpressAdapter } from '@nestjs/platform-express';
import * as express from 'express';
import * as functions from 'firebase-functions';
import { AppModule } from './app.module';

// 缓存已初始化的Nest应用实例
let cachedNestApp: any;

async function bootstrapNest(expressInstance: express.Express) {
  const app = await NestFactory.create(
    AppModule,
    new ExpressAdapter(expressInstance),
  );
  // 根据需求配置CORS、全局管道等
  app.enableCors({ origin: true });
  await app.init();
  return app;
}

export const nestApi = functions.https.onRequest(async (req, res) => {
  if (!cachedNestApp) {
    const expressApp = express();
    cachedNestApp = await bootstrapNest(expressApp);
  }
  // 将请求交给已初始化的Nest应用处理
  cachedNestApp.getHttpAdapter().getInstance()(req, res);
});

2. 避免在请求处理流程中重复初始化

不要在每次请求触发时都重新创建Nest实例，而是通过全局变量缓存实例，冷启动时只初始化一次，后续热启动直接复用。

3. 可选：优化冷启动速度

• 启用Firebase Functions的预留实例：通过控制台或命令行配置预留实例，让函数保持活跃状态，减少冷启动场景
• 精简Nest依赖：移除不必要的模块、中间件或第三方库，缩小代码体积，加快初始化速度
• 启用Tree Shaking：在构建配置中开启Tree Shaking，剔除未使用的代码，优化打包后的文件大小

原理说明 #

通过异步等待app.init()完成，确保Nest的所有模块、控制器和依赖都已初始化完成后，再将请求交给Nest处理。同时缓存实例避免重复初始化，既保证了冷启动时请求能等待到Nest就绪，又提升了热启动的响应速度。

内容的提问来源于stack exchange，提问作者MatejG