Cloud Functions单体仓库部署报错：依赖缺失问题咨询

现有方案的正确性 #

你提到的两个解决方案都是完全可行的，各自适配不同场景：

• 私有仓库发布：适合团队协作或长期维护的项目，能标准化依赖版本管理，不用维护本地打包脚本，但需要搭建或使用私有仓库服务，初期配置有一定成本。
• predeploy钩子+npm pack复制：适合小型项目或快速迭代场景，无需额外依赖仓库，直接在部署流程中处理本地包，但要维护自定义脚本，每次部署都会重复打包操作。

更简单的替代方案 #

1. 直接复制编译后的包文件（轻量脚本） #

跳过npm pack的打包和解包步骤，直接写简单脚本把@app/config的编译产物复制到函数目录的node_modules下。
比如在Cloud Functions目录的package.json中添加脚本：

"scripts": {
  "sync-config": "mkdir -p node_modules/@app/config && cp -R ../../packages/config/dist/cjs/* node_modules/@app/config/"
}

然后在firebase.json中配置predeploy钩子自动执行：

{
  "functions": {
    "predeploy": ["npm --prefix \"$RESOURCE_DIR\" run sync-config"]
  }
}

这种方式操作简单，没有额外的打包开销，适合纯JS/TS编译后的直接复用场景。

2. 用打包工具将依赖内置到函数代码 #

如果你的Cloud Functions使用Webpack、Esbuild这类打包工具，可以把@app/config作为内部依赖打包进最终的函数bundle里。部署时只需要上传这个包含所有依赖的单文件，彻底规避node_modules软链接的问题。
比如用Esbuild，只需在配置中指定函数入口文件，它会自动把@app/config的代码合并到输出文件中，同时支持tree-shaking减少包体积，适合代码量不大的函数。

3. 用npm install直接安装本地包（无软链接） #

在Cloud Functions目录下执行npm install --no-save ../../packages/config，这个命令会把本地包的实际文件复制到函数目录的node_modules，而不是创建软链接。把这个命令加到predeploy钩子即可：

{
  "functions": {
    "predeploy": ["npm --prefix \"$RESOURCE_DIR\" install --no-save ../../packages/config"]
  }
}

注意：执行前要确保@app/config已经完成编译（dist目录存在），否则会把未编译的源码复制过去，导致云端运行报错。

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