升级Firebase-tools至12.4.3后部署及初始化报错求助

问题描述 #

本地Firebase项目在模拟器中运行正常，但升级firebase-tools至12.4.3版本后，部署及执行firebase init时均触发以下错误：

Error: FetchError: Invalid response body while trying to fetch https://serviceusage.googleapis.com/v1/projects/[project-name]/services/cloudfunctions.googleapis.com: incorrect data check

环境配置 #

• MacOS v10.13.6
• Node.js v16.20.1（受系统限制无法升级至Node 18）
• NPM v8.19.4
• TSC 5.1.6
• Firebase-tools 12.4.3

已尝试操作 #

• 升级Node 18失败（系统版本不足），回退至Node 16.20.1
• 完全卸载NPM，执行sudo npm cache clear --force清理缓存
• 重新安装NPM 8.19.4、Firebase及firebase-tools 12.4.3

排查与解决步骤 #

1. 降级firebase-tools到兼容Node 16的稳定版本 #

firebase-tools 12.4.3可能存在Node 16兼容性问题，尝试降级至12.3.x版本：

npm uninstall -g firebase-tools
npm install -g firebase-tools@12.3.1

验证版本：

firebase --version

完成后重新尝试部署或初始化操作。

2. 排查SSL证书与网络代理问题 #

"incorrect data check"错误常与SSL校验、网络代理相关：

• 关闭所有代理工具（VPN、本地代理等），直接连接网络重试
• 重置MacOS SSL证书缓存：

  sudo security flush-keychain -s
  

  或打开「钥匙串访问」→「系统」钥匙串，删除serviceusage.googleapis.com相关证书后重试
• 指定Node使用自定义CA证书：
  下载根CA证书包保存为ca.pem，执行命令时添加环境变量：

  NODE_EXTRA_CA_CERTS=/path/to/ca.pem firebase deploy
  

3. 检查网络连接稳定性 #

• 切换至其他网络（如手机热点），排除本地运营商网络限制
• 测试API地址连通性：

  curl -v https://serviceusage.googleapis.com/v1/projects/[你的项目名]/services/cloudfunctions.googleapis.com
  

若curl也报错，需排查防火墙、DNS设置等网络层面问题。

4. 清理Firebase本地与全局缓存 #

• 删除现有项目下的.firebase目录
• 清理Firebase CLI全局缓存并重新登录：

  firebase logout
  rm -rf ~/.firebase
  firebase login
  

5. 验证Node.js与NPM完整性 #

重新确认Node和NPM安装状态：

node -v
npm -v
npm verify cache

若npm verify cache报错，下载Node.js 16.20.1官方安装包覆盖安装。

内容的提问来源于stack exchange，提问作者David from GB Console