NestJS部署Firebase Cloud Functions启动阶段CORS策略失效问题的解决方法

我之前也碰到过几乎一模一样的情况——本地用npm run start测试时所有请求都正常，但部署到Firebase Cloud Functions或者用firebase serve --only functions模拟生产环境时，服务启动/重启阶段总会有部分请求触发CORS拦截，而且闲置5分钟后函数被回收重启，这个问题又会复现。结合你的代码和场景，分享下我验证有效的解决方案：

核心问题根源 #

Firebase Cloud Functions的冷启动机制是关键：函数闲置一段时间会被云端回收，再次收到请求时会重新初始化服务。原来的代码只在文件加载时调用一次createNestServer，冷启动后可能在Nest服务完全初始化、CORS配置生效前就收到请求，导致首次请求触发CORS错误。

解决方案步骤 #

1. 修改Firebase函数入口，确保每次请求都完成Nest服务初始化 #

把原来直接导出函数的方式，改成在请求处理逻辑中先等待Nest服务初始化完成，再处理请求，这样冷启动时CORS配置一定会被正确加载：

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

const server = express();
export const createNestServer = async (expressInstance) => {
  const app = await NestFactory.create(
    AppModule,
    new ExpressAdapter(expressInstance),
  );
  const whitelist = [
    'http://localhost:8100/',
    'http://localhost:8100',
    '*',
    undefined,
  ];
  app.enableCors({
    origin: function (origin, callback) {
      console.log(origin);
      // 优化白名单匹配逻辑，避免精确匹配的边界问题
      if (whitelist.some(x => !x || origin?.startsWith(x.replace(/\/$/, '')))) {
        console.log('The CORS policy for this site allows access from ', origin);
        callback(null, true);
      } else {
        console.log('The CORS policy for this site does not allow access from ', origin);
        callback(
          new Error('The CORS policy for this site does not allow access from ' + origin),
          false,
        );
      }
    },
    allowedHeaders: 'X-Requested-With, X-HTTP-Method-Override, Content-Type, Accept, Observe',
    methods: 'GET, OPTIONS',
    credentials: true,
    preflightContinue: true,
    optionsSuccessStatus: 200,
  });
  return app.init();
};

// 关键修改：每次请求都先确保Nest服务初始化完成
export const api = functions
  .region('us-central1')
  .https.onRequest(async (request, response) => {
    await createNestServer(server);
    server(request, response);
  });

2. 优化TypeORM连接配置，避免冷启动重复建连 #

给TypeORM添加keepConnectionAlive: true配置，让数据库连接在函数冷启动后保持活跃，既提升服务稳定性，也能减少连接初始化的延迟：

export const config: TypeOrmModuleOptions = {
  type: 'mysql',
  port: 3306,
  host: 'xxx.xxx.xxx.xxxx',
  database: 'name_of_the_database',
  username: 'username',
  password: 'password',
  synchronize: false,
  entities: [Entity1, Entity2],
  autoLoadEntities: true,
  keepConnectionAlive: true, // 核心配置，保持连接存活
};

为什么这样能解决问题？ #

• 原来的代码只在文件加载时初始化一次Nest服务，Firebase冷启动后文件重新加载，但可能在服务完全初始化前就收到请求，导致CORS配置未生效。现在每次请求都等待createNestServer完成，确保CORS策略已经加载完毕。
• keepConnectionAlive让TypeORM在函数闲置回收后，再次启动时复用现有数据库连接，避免重复建连的开销，同时减少因连接初始化延迟导致的请求异常。

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