使用IAM服务账号部署Firebase云函数及路径错误排查

一、解决找不到lib/index.js的问题 #

针对部署时提示找不到lib/index.js的情况，可尝试以下操作：

• 确认构建步骤已执行：如果项目用TypeScript编写，必须先执行编译命令生成lib目录。运行npm run build或直接执行tsc，检查项目根目录下是否生成了lib/index.js文件。
• 校验package.json的main字段：确保main字段的值是正确的相对路径，比如TypeScript项目通常设为"lib/index.js"。同时检查路径拼写、大小写是否和实际文件一致（比如避免把lib写成Lib）。
• 指定部署的源目录：如果执行gcloud命令时不在functions目录下，需要通过--source参数明确指定函数代码的目录。例如：

  gcloud functions deploy MyFunction --source ./functions --service-account my-function@my-project.iam.gserviceaccount.com
  

• 清理缓存后重新构建：删除node_modules和lib目录，重新运行npm install和构建命令，排除缓存导致的文件缺失问题。

二、使用IAM服务账号部署Firebase云函数 #

firebase deploy命令不支持直接通过--service-account参数指定服务账号，需通过环境变量配置服务账号密钥来实现：

1. 下载目标IAM服务账号的JSON密钥文件到本地。
2. 设置环境变量指向该密钥文件：
   • macOS/Linux终端：

     export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your-service-account-key.json"
     

   • Windows命令提示符：

     set GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your-service-account-key.json"
     

3. 执行部署命令：

   firebase deploy --only functions:MyFunction
   

4. 确保该服务账号拥有足够的部署权限，比如Cloud Functions Developer、Firebase Admin等相关角色。

内容的提问来源于stack exchange，提问作者Thomas David Kehoe