GitHub Actions部署多个Firebase函数异常问题咨询

故障原因 #

部署失败的核心诱因是--only参数的多函数列表格式不符合CI环境的shell解析规则：函数名之间的逗号后如果存在空格，会被shell识别为参数分隔符，导致Firebase CLI仅能读取到第一个函数名，第二个函数路径会被判定为无效的独立参数，最终中断部署流程。
本地交互式shell对参数解析有容错机制，因此带空格的写法可以正常运行；单函数部署不存在逗号分隔场景，因此也不会触发该问题。

修复方法 #

直接修改package.json内的部署脚本，删除函数列表逗号后的多余空格即可，正确配置如下：

{
  "scripts": {
    "deploy:prod": "firebase use prod && firebase deploy --only functions:fun1,functions:fun2"
  }
}

注意：Firebase CLI的--only参数接收多资源列表时，标准格式为逗号分隔、无额外空格，无论本地还是CI环境都建议遵循该写法避免兼容问题。

可选配置优化 #

如果需要进一步提升CI流程稳定性，可以将firebase-tools改为全局安装，避免项目依赖版本和CLI版本冲突，调整后的工作流步骤参考：

name: Deploy PROD
on:
  workflow_dispatch:

jobs:
  build_and_deploy_functions_prod:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install npm packages
        run: |
          cd functions
          npm ci
          npm install -g firebase-tools
      - name: Deploy to Firebase
        run: cd functions && npm run deploy:prod
        env:
          FIREBASE_TOKEN: ${{ secrets.FIREBASE_TOKEN }}

修改完成后重新触发GitHub Actions工作流，即可正常完成多个函数的批量部署。

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