如何在Express+Firebase Functions中共享Firestore实例？

这个问题我之前在做Firebase Functions + Express项目的时候也踩过坑！核心问题就是要保证Firebase Admin App只初始化一次，同时让所有控制器能安全复用同一个Firestore实例。我来给你梳理下正确的做法：

第一步：修正Firebase服务文件的初始化逻辑 #

你的服务文件之前直接调用initializeApp()，但没有做重复初始化的判断，而且在Functions环境中其实可以简化配置的传入。修改后的服务文件应该是这样的：

// ./services/firebase.service.ts
import * as admin from 'firebase-admin';
import * as functions from 'firebase-functions';

// 关键：先检查是否已经有初始化的App实例，避免重复初始化
if (!admin.apps.length) {
  // 在Firebase Functions环境中，initializeApp可以不用传config，会自动读取环境配置
  admin.initializeApp();
}

// 初始化并导出Firestore实例
const firestore = admin.firestore();
export const db = firestore;

为什么要加!admin.apps.length的判断？因为Node.js模块虽然是单例缓存的，但在Functions的冷启动或者某些特殊场景下，可能会出现模块被重新加载的情况，这个判断是双重保险，既不会触发“App已存在”的错误，也能确保App被正确初始化。

第二步：控制器正常导入使用 #

你的控制器代码不用大改，保持原来的导入方式就行，因为现在服务文件会保证db是已经初始化好的Firestore实例：

// ./controllers/test.ts
import { db } from './../services/firebase.service';
import express from 'express';

const router = express.Router();
// 这里可以安全地获取集合引用
const contactsCollection = db.collection('contacts');

router.post('/', (req, res) => {
  // 示例：添加文档到集合
  contactsCollection.add(req.body)
    .then(docRef => {
      res.status(201).json({ id: docRef.id, message: 'Contact created successfully' });
    })
    .catch(error => {
      res.status(500).json({ error: `Failed to create contact: ${error.message}` });
    });
});

export const TestController = router;

第三步：Express主文件完善配置 #

你的app.js代码基本没问题，不过记得加上express.json()中间件，不然解析不了POST请求的JSON body：

// app.js
import express from 'express';
import { TestController } from './controllers/test';
import * as functions from 'firebase-functions';

const app = express();
// 必须添加这个中间件才能解析JSON格式的请求体
app.use(express.json());

app.use('/contact', TestController);

export const api = functions.https.onRequest(app);

为什么之前会报错？ #

你之前遇到的The default Firebase app does not exist错误，大概率是因为服务文件的初始化逻辑执行时机有问题（比如控制器先加载，但App还没初始化完成）；而如果在每个控制器都调用initializeApp()，又会因为重复初始化触发App已存在的错误。通过在服务文件中统一处理初始化逻辑并加判断，就能完美解决这两个问题。

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