GitHub Actions中npm CI && npm run build失败，Firebase部署遇阻

问题描述 #

在通过GitHub Actions部署Firebase Hosting PR预览时，执行npm ci && npm run build步骤失败，对应的Workflow配置如下：

name: Deploy to Firebase Hosting on PR
"on": pull_request
jobs:
  build_and_preview:
    if: "${{ github.event.pull_request.head.repo.full_name == github.repository }}"
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - run: npm ci && npm run build
      - uses: FirebaseExtended/action-hosting-deploy@v0
        with:
          repoToken: "${{ secrets.GITHUB_TOKEN }}"
          firebaseServiceAccount: "${{ secrets.SECRET }}"
          projectId: projectId

已尝试操作：

• 移除npm ci仅保留npm run build
• 本地删除node_modules、package-lock.json后重新安装依赖，本地构建正常，但CI环境仍失败

排查与解决方案 #

1. 统一Node.js版本 #

GitHub Actions默认Ubuntu镜像的Node.js版本可能和本地不一致，引发依赖或构建兼容性问题。
在Workflow中添加setup-node步骤指定匹配版本：

steps:
  - uses: actions/checkout@v2
  - uses: actions/setup-node@v3
    with:
      node-version: '18' # 替换为你本地使用的Node.js版本（如16、20）
      cache: 'npm' # 启用依赖缓存，加速安装
  - run: npm ci && npm run build

2. 确保lock文件与package.json同步 #

npm ci会严格按照package-lock.json安装依赖，若lock文件未随package.json更新，CI会报错。

• 本地执行npm install更新package-lock.json，提交到仓库后重新运行Workflow
• 若无需严格依赖一致性，可临时将npm ci替换为npm install（不推荐长期使用）

3. 配置CI环境所需的环境变量 #

本地构建时可能依赖自定义环境变量，但CI环境未配置，导致npm run build失败。

• 在GitHub仓库Settings > Secrets and variables > Actions中添加所需环境变量
• 在Workflow中引入变量：

steps:
  - uses: actions/checkout@v2
  - uses: actions/setup-node@v3
    with:
      node-version: '18'
      cache: 'npm'
  - run: npm ci && npm run build
    env:
      REACT_APP_API_URL: ${{ secrets.REACT_APP_API_URL }} # 替换为你的环境变量名

4. 解决依赖安装权限问题 #

Ubuntu环境下部分依赖安装需要额外权限，可通过以下命令调整：

run: |
  npm config set unsafe-perm true
  npm ci && npm run build

若依赖需全局安装，添加npm install -g <package>步骤（替换为实际需要的包）。

5. 清理CI依赖缓存 #

GitHub Actions的缓存可能残留旧依赖导致异常：

• 暂时移除cache: 'npm'配置，重新运行Workflow
• 或在仓库Actions页面的对应Workflow中，进入Caches选项卡手动清理缓存

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