Git使用ssh克隆时报fatal: fetch-pack: invalid index-pack output错误如何解决

1 SSH连接配置适配 #

• 优先调整SSH客户端配置，解决大流量传输下的兼容性问题：编辑本地~/.ssh/config（Windows系统为C:\Users\你的用户名\.ssh\config），在对应Git服务的Host配置块中添加以下参数：

  Host 你的Git服务域名
    ServerAliveInterval 60
    ServerAliveCountMax 10
    TCPKeepAlive yes
    IPQoS throughput
  

  保存后重新执行clone操作即可，大部分场景下该报错是SSH默认QoS标记与中间网络设备不兼容导致大流量传输被中断，IPQoS throughput参数可解决这类兼容性问题。
• 排查网络MTU适配问题：执行ping -s 1400 -M do 你的Git服务域名（Windows系统命令为ping -f -l 1400 你的Git服务域名），逐步降低1400的数值直到无分片报错，将最终数值减28（IP+ICMP头长度）设置为网卡的MTU值即可。WiFi网络环境建议优先切换有线网络排除无线丢包干扰。

2 Git传输参数调整 #

• 临时关闭压缩校验测试：执行clone命令时添加配置参数：

  git clone -c core.compression=0 ssh://你的仓库地址
  

  部分场景下传输过程中的压缩计算校验出错会触发fatal: fetch-pack: invalid index-pack output报错。
• 调大SSH传输缓冲区：执行全局配置命令设置缓冲区为500M，适配大仓库全量传输需求：

  git config --global ssh.postBuffer 524288000
  

3 版本兼容与服务端排查 #

• 升级本地Git版本至2.20以上稳定版，旧版本Git存在SSH传输校验逻辑的已知缺陷，可能触发该类偶发报错。
• 如果是自行搭建的Git服务端，可排查服务端SSH运行日志，确认是否存在连接限流、磁盘存储空间不足、仓库文件权限异常等问题。

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