如何在1.4GB大体积Git仓库成功执行git clone --mirror不报错？

你遇到的两次报错均属于大体积Git仓库HTTP传输场景下的常见问题，90%以上的同类报错都是网络链路不稳定导致的，少数为服务端传输限制或远端仓库本身存在完整性问题。

可尝试的解决措施 #

• 更换传输协议为SSH：HTTPS为短连接协议，传输大体积文件时极易被运营商、防火墙或服务端的超时策略强制断开，SSH长连接的传输稳定性远高于HTTPS。先将你的SSH公钥配置到Bitbucket账号，再执行git clone --mirror git@bitbucket.org:xxx/my-app.git尝试克隆。
• 调整Git HTTP超时配置：如果必须使用HTTPS协议，执行以下命令调整HTTP传输阈值，避免低速传输时被主动断连：

  git config --global http.lowSpeedLimit 0
  git config --global http.lowSpeedTime 999999
  

• 分批拉取提交历史：放弃一次性全量克隆，采用浅克隆+逐步加深的方式拉取所有历史：
  1. 先执行git clone --depth 1 https://xxx@bitbucket.org/xxx/my-app.git拉取最近1次提交
  2. 进入仓库目录，反复执行git fetch --deepen 100，每次多拉取100条提交历史，直到所有历史拉取完成。你之前使用--deepen 1每次仅拉1条，容易触发服务端的频繁连接限制，调整为每次50-100条即可。
• 修正Git压缩配置：你当前配置中core.compression = 0为关闭压缩，会导致传输的pack包体积大幅增加，反而提高断连概率。执行git config --global core.compression 6恢复默认压缩等级，减小传输体积。
• 排查网络链路：先执行ping bitbucket.org检查链路丢包率，如果丢包率超过2%，说明你当前网络到Bitbucket的国际出口链路不稳定，可尝试更换网络环境（如切换运营商、使用手机热点、调整代理节点）后重试。

是否需要联系Bitbucket官方 #

在完成上述所有排查操作后，如果仍然返回fatal: protocol error: bad pack header错误，再联系Bitbucket官方处理：

1. 你可以先在Bitbucket仓库的管理后台找到仓库完整性检查工具，主动触发一次仓库修复，排除远端仓库本身损坏的可能
2. 若自助修复无效，再提交工单提供你的报错日志，请求官方协助排查。

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