Firebase Functions CLI部署依赖疑问及GitHub Actions CI配置求助

核心问题：上传node_modules还是云端安装？ #

• Firebase CLI部署Node.js函数时，默认不会上传本地的node_modules目录，而是基于你的package.json和锁文件（package-lock.json/yarn.lock）在云端自动安装对应版本的依赖。
• 这个机制既避免了上传大体积依赖包的冗余，又能通过锁文件保证云端依赖版本与本地开发环境完全一致。

GitHub Actions CI中依赖找不到的问题处理 #

你不需要在firebase.json中通过predeploy选项执行npm ci，但要注意两个关键细节：

1. CI流程的本地依赖安装要求
   • 如果你的函数需要本地预处理（比如TypeScript转译、ESLint检查，或依赖包含需本地构建的原生模块），CI流程中必须先进入functions目录执行npm ci，否则预处理步骤会因找不到依赖而失败。
   • 即使是纯JavaScript函数，为了和云端依赖版本完全对齐，也建议执行npm ci（利用锁文件安装精确版本）。
2. 云端函数找不到依赖的排查方向
   • 检查functions/package.json：确保所有运行时必需的依赖都在dependencies中，云端不会安装devDependencies里的包。
   • 确认锁文件已提交到GitHub：Firebase CLI会优先读取锁文件安装云端依赖，避免版本不一致导致的缺失。

示例GitHub Actions部署步骤片段 #

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 18 # 匹配Firebase函数指定的Node.js版本
          cache: 'npm'
      - name: Install functions dependencies
        working-directory: ./functions
        run: npm ci
      - name: Deploy to Firebase
        uses: FirebaseExtended/action-hosting-deploy@v0
        with:
          repoToken: '${{ secrets.GITHUB_TOKEN }}'
          firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT }}'
          projectId: your-firebase-project-id
          channelId: live

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