多Codebase的Firebase Functions共享本地Node模块部署问题

问题场景 #

我正在用Firebase Codebase特性重构Cloud Functions，通过在functions目录下创建独立的codebaseA、codebaseB目录（各带自己的package.json）实现函数隔离。同时在functions根目录维护了一个shared模块，存放公共函数、常量和类型，供多个codebase依赖。

按照官方依赖处理指引，我给每个codebase的package.json添加了"shared": "file:../shared"的依赖，本地开发完全正常，但部署时发现Firebase无法解析shared目录——推测是部署流程遵循codebase隔离原则，忽略了codebase目录外的文件。

目前我用firebase.json的predeploy/postdeploy脚本临时解决：部署前把shared复制到codebase目录并修改依赖路径，部署后恢复。但这个方案太繁琐，想找更优雅的官方推荐方案，同时不确定Stack Overflow提到的firelink是否适用。

优雅解决方案 #

方案1：利用Firebase Functions的include配置（最简单） #

Firebase允许在firebase.json中为每个codebase配置额外需要包含的文件/目录，直接把shared目录纳入部署包即可，无需修改依赖路径或复制文件：

{
  "functions": [
    {
      "codebase": "codebaseA",
      "source": "functions/codebaseA",
      "include": ["../shared/**"]
    },
    {
      "codebase": "codebaseB",
      "source": "functions/codebaseB",
      "include": ["../shared/**"]
    }
  ]
}

配置后，部署每个codebase时，Firebase会自动将../shared下的所有内容打包到部署包中，package.json里的file:../shared依赖就能正常解析，本地开发的配置完全不用改。

方案2：用Monorepo Workspaces（推荐长期维护） #

如果你的项目涉及多个共享模块或复杂依赖关系，官方更推荐用npm/pnpm/yarn的workspace功能管理monorepo，从根源上解决依赖解析问题：

1. 在functions根目录创建package.json，声明workspaces：

{
  "name": "functions-workspace",
  "private": true,
  "workspaces": [
    "shared",
    "codebaseA",
    "codebaseB"
  ]
}

2. 修改每个codebase的package.json，把shared依赖改为：

"dependencies": {
  "shared": "*"
}

3. 在functions目录下执行npm install（或pnpm/yarn），工具会自动在每个codebase的node_modules中创建shared的软链接，本地开发和部署都能正常解析。

这种方式不仅解决了部署问题，还能统一管理所有codebase和共享模块的依赖，适合长期维护的项目。

关于firelink的适用性 #

firelink主要用于本地开发时，将本地的Firebase Functions模块链接到项目中，避免频繁发布测试。对于你的共享模块场景，如果你已经用了workspace或include配置，firelink并不是必须的。但如果你的shared模块需要单独开发测试，firelink可以辅助本地调试，但部署时还是需要依赖上述两种方案来确保共享模块被正确打包。

对比现有脚本方案 #

• 脚本方案需要手动复制文件、修改依赖路径，容易出错且维护成本高；
• include配置只需修改firebase.json，零侵入现有代码，适合简单场景；
• Monorepo Workspaces是官方推荐的长期解决方案，能统一管理依赖，支持复杂项目结构。

内容的提问来源于stack exchange，提问作者Henk van der Sloot