如何管理需独立依赖的多个Firebase Functions？

背景 #

当前项目有10个Firebase Functions，全部定义在index.ts中，所有依赖都集中在同一个package.json里。虽然目前运行正常，但随着函数计划扩展到100个，会面临以下问题：

• 依赖冲突风险提升
• 每个函数加载不必要的依赖，增加冷启动时间
• 代码可读性差，长期维护成本高

当前项目结构：

firebase-project/
  firebase.json
  functions/
    package.json
    src/
      index.ts

核心需求：为每个函数单独配置package.json，实现依赖完全隔离。

已评估的方案 #

• npm workspace：尝试拆分多目录但无法设置独立入口，若合并到单个index.ts则失去隔离意义，放弃。
• 多仓库codebase：需为每个函数创建独立Firebase项目，过于冗余，放弃。
• 单仓库codebase：官方文档提及但缺乏实际示例，不确定具体实现方式。
• 传统Cloud Functions：可行但需自行实现Firebase Auth等集成功能，作为最后备选。

目标 #

实现类似传统Cloud Functions的独立依赖结构，但保留Firebase Functions的原生集成能力，采用单仓库codebase方案。

完整项目结构实现 #

最终目录结构 #

firebase-project/
  # 根项目配置
  firebase.json
  .firebaserc
  
  # 函数集合目录
  functions/
    # 函数级统一配置文件
    firebase.json
    
    # 第一个函数独立模块
    user-auth/
      index.ts
      package.json
      tsconfig.json（可选，按需自定义TypeScript规则）
    
    # 第二个函数独立模块
    order-processing/
      index.ts
      package.json
      tsconfig.json（可选）
    
    # 共享工具模块（可选，供多函数复用公共逻辑）
    shared/
      utils.ts
      package.json

关键配置说明 #

1. 根目录firebase.json
   仅保留非Functions相关的Firebase服务配置（如Hosting、Firestore规则等），Functions的配置移至子目录：

{
  "firestore": {
    "rules": "firestore.rules",
    "indexes": "firestore.indexes.json"
  },
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  }
}

2. 根目录.firebaserc
   指定默认项目，并为每个函数模块设置别名，方便快速部署：

{
  "projects": {
    "default": "your-firebase-project-id",
    "user-auth": "your-firebase-project-id",
    "order-processing": "your-firebase-project-id"
  }
}

3. functions/firebase.json
   配置每个函数的codebase，指定各自的源代码目录和依赖配置路径：

{
  "functions": [
    {
      "codebase": "user-auth",
      "source": "user-auth",
      "runtime": "nodejs20",
      "ignore": [
        "node_modules",
        ".git",
        "firebase-debug.log",
        "firebase-debug.*.log"
      ]
    },
    {
      "codebase": "order-processing",
      "source": "order-processing",
      "runtime": "nodejs20",
      "ignore": [
        "node_modules",
        ".git",
        "firebase-debug.log",
        "firebase-debug.*.log"
      ]
    }
  ]
}

4. 单个函数的package.json示例（以user-auth为例）
   仅安装该函数所需的依赖，避免冗余：

{
  "name": "user-auth-functions",
  "version": "1.0.0",
  "main": "index.ts",
  "scripts": {
    "build": "tsc",
    "serve": "firebase emulators:start --only functions:user-auth",
    "deploy": "firebase deploy --only functions:user-auth"
  },
  "dependencies": {
    "firebase-admin": "^12.0.0",
    "firebase-functions": "^4.6.0"
  },
  "devDependencies": {
    "typescript": "^5.3.0"
  }
}

5. 单个函数的index.ts示例
   定义独立的Firebase Function：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";

admin.initializeApp();

export const createUser = functions.https.onCall(async (data, context) => {
  const { email, password } = data;
  const userRecord = await admin.auth().createUser({ email, password });
  return { uid: userRecord.uid };
});

部署与运行 #

• 部署单个函数：进入对应函数目录执行npm run deploy，或在根目录执行firebase deploy --only functions:user-auth
• 本地调试单个函数：进入对应函数目录执行npm run serve，或在根目录执行firebase emulators:start --only functions:user-auth

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