Firebase Hosting部署失败：重试耗尽+JSON循环结构转换错误

针对部署时文件上传卡0%、重试后触发TLSSocket循环结构转JSON错误的问题，以下是几个实用的排查和解决方向：

• 定位问题文件：既然单个index.html能正常上传，说明是部分构建文件导致的异常。尝试分批上传dist/prod下的文件（比如先传css/js文件夹，再传静态资源），找到触发错误的具体文件，排查是否存在损坏的二进制文件（如图片、字体）、包含特殊字符的文件名或超大文件。
• 调整Firebase CLI版本：当前使用的12.5.4版本可能存在网络请求处理的bug，尝试升级到最新稳定版或降级到12.x早期版本（如12.0.0）：

  # 降级到指定版本
  npm install -g firebase-tools@12.0.0
  # 或升级到最新版
  npm install -g firebase-tools@latest
  

• 强制单线程上传：并行上传可能引发网络层异常，修改firebase.json的Hosting配置，限制并发连接数：

  {
    "hosting": {
      "target": "prod",
      "public": "dist/prod",
      "maxConcurrentConnections": 1,
      // 保留原有其他配置
    }
  }
  

  保存后重新执行部署命令。
• 彻底清理缓存与重构：除了删除.firebase文件夹，还要清理前端项目的构建缓存（如Vite的.vite目录、Webpack的node_modules/.cache），然后重新构建产物：

  # 以Vite项目为例
  rm -rf .vite dist/prod
  vite build
  

  再尝试部署。
• 排查网络拦截：关闭本地所有代理软件、系统防火墙及第三方安全工具，避免这类工具干扰Firebase的上传连接，导致TLSSocket状态异常。
• 临时手动上传恢复服务：如果以上方法都无效，可通过Firebase控制台的Hosting页面，手动上传dist/prod的所有文件，先恢复网站服务，再后续排查CLI的底层问题。

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