执行firebase ext:install .时遇FirebaseError：响应超出harpoon最大页面大小

当执行firebase ext:install .安装自定义Firebase扩展时出现could not read archive: response exceeded harpoon max page size错误，本质是扩展源码目录打包后的归档文件超出了Firebase允许的大小限制，或目录中包含大量不必要文件导致打包体积异常。以下是具体解决方法：

• 清理并排除冗余文件
  在扩展根目录创建.firebaseignore文件，配置规则排除无需上传的文件/目录，示例规则：

  node_modules/
  .git/
  logs/
  *.log
  temp/
  dist/*.js.map
  

  该文件作用类似.gitignore，会告知Firebase CLI哪些内容不需要打包上传。

• 手动打包扩展源码
  若自动打包仍有问题，可手动将扩展核心文件（extension.yaml、源码文件、必要依赖文件等）打包为zip压缩包，再执行以下命令安装：

  firebase ext:install ./your-extension-package.zip
  

• 更新Firebase CLI到最新版本
  旧版本CLI可能存在打包逻辑bug，执行命令更新：

  npm install -g firebase-tools
  

• 检查目录大小
  确认扩展目录（排除冗余后）总大小不超过Firebase扩展限制（当前官方限制为扩展包最大100MB），若存在大文件（如测试静态资源、数据库备份），务必移除或通过其他方式加载，不要包含在扩展包内。

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