Firebase本地模拟器套件安装报错：下载文件大小不符求助

问题场景 #

执行firebase init emulators完成配置后，下载Firestore模拟器时出现文件大小不匹配错误：

i  firestore: 正在下载cloud-firestore-emulator-v1.17.2.jar...
进度: ===========================================================================================================> (65MB的100%) 

Error: download failed, expected 64907894 bytes but got 64723779

排查解决步骤 #

• 清理本地模拟器缓存
  Firebase CLI会缓存下载的模拟器文件，缓存损坏是常见诱因：

  1. 执行命令触发缓存清理：firebase emulators:exec "echo clear cache"
  2. 或手动删除对应缓存文件：
     • Windows路径：%APPDATA%\firebase\emulators
     • macOS/Linux路径：~/.cache/firebase/emulators
       删除cloud-firestore-emulator-v1.17.2.jar后重新尝试下载。

• 检查网络稳定性
  不稳定的网络或代理/防火墙拦截会导致下载不完整：

  • 切换到有线网络或信号更稳定的Wi-Fi
  • 暂时关闭系统防火墙、VPN或代理工具，避免下载请求被截断

• 手动下载替换文件
  绕过CLI的自动下载逻辑，手动获取完整安装包：

  1. 执行firebase init emulators --debug查看完整的模拟器下载链接
  2. 下载完整的cloud-firestore-emulator-v1.17.2.jar文件
  3. 将文件放入本地模拟器缓存目录，覆盖已损坏的文件

• 更新Firebase CLI
  旧版本CLI可能存在下载逻辑缺陷，执行命令更新到最新版：

  npm install -g firebase-tools
  

  更新完成后重新运行初始化流程。

• 重新执行初始化
  清理缓存并确保网络正常后，再次运行firebase init emulators，选择重新下载模拟器。

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