部署大型静态站点至Firebase Hosting超时问题及压缩包部署咨询

我正在部署一个大型静态站点，该站点包含约71000个小文件，总大小接近2GB，打包压缩后的tar.gz文件不超过33MB。我的网络连接状况良好（1G下载/100M上传），但执行firebase deploy --only hosting命令10分钟后出现超时错误，错误信息如下：

[2022-10-15T17:45:08.396Z] Error: Timed out.
    at Timeout._onTimeout (/home/angelcc/.nvm/versions/node/v16.17.1/lib/node_modules/firebase-tools/lib/utils.js:253:49)
    at listOnTimeout (node:internal/timers:559:17)
    at processTimers (node:internal/timers:502:7)

Error: An unexpected error has occurred.

现咨询以下两个问题：

1. 如何在此规模下部署Firebase Hosting站点？
2. 是否可通过推送压缩包的方式避免超时？

针对问题1：大规模Firebase Hosting站点部署方案 #

• 调优上传参数
  直接修改firebase-tools的并发上传数和超时阈值，适配小文件批量上传场景：

  firebase deploy --only hosting --max-concurrent=50 --timeout=3600000
  

  --max-concurrent调高同时上传的文件数量（小文件对并发支持更好），--timeout将超时时间设为1小时（单位毫秒），避免因文件过多触发超时。

• 启用增量部署
  在firebase.json中配置合理的缓存规则，Firebase Hosting会自动跳过未修改的文件，仅上传变更内容，大幅减少后续部署的工作量：

  {
    "hosting": {
      "public": "dist",
      "headers": [
        {
          "source": "**/*.{js,css,png,jpg}",
          "headers": [{"key": "Cache-Control", "value": "public, max-age=31536000"}]
        }
      ]
    }
  }
  

• 拆分托管目标
  如果站点可按模块拆分，在firebase.json中配置多个hosting目标，分批次部署不同模块：

  {
    "hosting": [
      {
        "target": "main-page",
        "public": "dist/main"
      },
      {
        "target": "static-assets",
        "public": "dist/assets"
      }
    ]
  }
  

  部署时指定单个目标：firebase deploy --only hosting:static-assets，分散单次部署的文件数量。

• 改用CI/CD平台部署
  借助GitHub Actions、GitLab CI等平台执行部署，这类环境通常有更稳定的网络和更长的超时限制。示例GitHub Actions片段：

  - name: Deploy to Firebase
    uses: FirebaseExtended/action-hosting-deploy@v0
    with:
      repoToken: ${{ secrets.GITHUB_TOKEN }}
      firebaseServiceAccount: ${{ secrets.FIREBASE_SERVICE_ACCOUNT }}
      projectId: your-project-id
  

针对问题2：压缩包推送相关方案 #

Firebase Hosting官方不支持直接推送tar.gz压缩包部署，但可以通过以下间接方式实现类似效果：

• 本地解压+批量上传
  先在本地解压压缩包，再使用上述调优后的--max-concurrent和--timeout参数执行上传，33MB压缩包解压后的小文件，高并发上传能显著提升速度，避免超时。

• Cloud Storage中转+云端解压
  先将压缩包上传到Firebase Cloud Storage，再通过Cloud Function自动解压并同步到Hosting底层的存储桶：

  1. 将tar.gz文件上传到Cloud Storage指定目录；
  2. 创建Cloud Function，触发条件为该目录有文件上传，函数内执行解压逻辑，将文件复制到Hosting对应的Cloud Storage桶（格式为your-project-id.appspot.com）；
  3. 执行firebase hosting:channel:deploy或刷新Hosting缓存，使新文件生效。
     这种方式利用云端处理文件同步，避免本地上传的超时问题，稳定性更高。

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