如何在Firebase Cloud Functions中使用私有NPM包？部署失败求解决方案

下面是几种无需公开包就能正常部署的可行方案：

方案1：使用私有代码托管平台的包管理服务（以GitHub Packages为例） #

1. 将私有包发布到GitHub Packages，注意包名需带上你的GitHub用户名作为scope，格式如@你的用户名/你的包名
2. 在Cloud Functions的根目录下创建.npmrc文件，添加配置：

   @你的用户名:registry=https://npm.pkg.github.com/
   //npm.pkg.github.com/:_authToken=你的GitHub个人访问令牌（需开启read:packages权限）
   

3. 在Functions的package.json中正确引用带scope的包：

   "dependencies": {
     "@你的用户名/你的包名": "x.x.x"
   }
   

4. 为避免令牌泄露，建议用Firebase环境变量替代硬编码：
   • 先设置环境变量：firebase functions:config:set github.token="你的令牌"
   • 修改.npmrc内容：

     @你的用户名:registry=https://npm.pkg.github.com/
     //npm.pkg.github.com/:_authToken=${npm_config_github_token}
     

   • 部署前执行：export npm_config_github_token=$(firebase functions:config:get github.token)

方案2：本地路径依赖（适合小型项目或快速迭代） #

直接将私有包作为本地依赖引入，无需发布到任何仓库：

1. 修改Functions目录下package.json的依赖项，指向私有包的本地相对路径：

   "dependencies": {
     "你的包名": "file:../../你的私有包所在目录"
   }
   

2. 确保私有包已完成TypeScript编译（生成dist或lib目录），或在部署前先执行私有包的构建命令（如npm run build）
3. 直接执行部署命令，Firebase会自动将本地包打包上传至云端

方案3：NPM官方私有仓库认证部署 #

如果你的私有包托管在NPM官方私有仓库，可通过认证令牌让云端构建访问：

1. 本地执行npm login登录有权限访问私有包的NPM账号
2. 找到用户根目录下的.npmrc文件，复制其中//registry.npmjs.org/:_authToken=xxx这一行
3. 将该行粘贴到Cloud Functions目录下的.npmrc文件中
4. 执行部署命令，云端构建会通过该令牌拉取私有包

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