在HPC上克隆GitHub仓库遇RPC失败等错误的解决求助

问题描述 #

在高性能计算集群（HPC）上克隆GitHub仓库时，初始拉取进程正常：

remote: Enumerating objects: 1059, done.
remote: Counting objects: 100% (1059/1059), done.
remote: Compressing objects: 100% (951/951), done.
Receiving objects: 23% (434/1809), 1.21 GiB | 9.59 MiB/s

但进程突然中断，抛出以下错误：

error: RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly: CANCEL (err 8)
error: 7130 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

已尝试git config --global http.postBuffer 10000M和git clone --depth 1 <仓库HTTP地址>，均未解决问题。

可行解决方法 #

1. 强制使用HTTP/1.1协议

HPC集群的网络设备常对HTTP/2支持不佳，禁用HTTP/2改用HTTP/1.1：

# 全局配置生效
git config --global http.version HTTP/1.1
# 或仅本次克隆生效
git clone --config http.version=HTTP/1.1 <仓库完整地址>

2. 分阶段浅层克隆+逐步拉取完整历史

单次拉取大仓库易中断，可分批次加深克隆深度：

# 先克隆深度为50的浅层仓库
git clone --depth 50 <仓库地址>
cd <仓库目录>
# 逐步扩大拉取深度
git fetch --depth 100
git fetch --depth 500
# 最终拉取完整历史
git fetch --unshallow

3. 检查并配置HPC网络代理

HPC集群通常有网络代理或防火墙限制，按需配置：

# 设置HTTP代理（替换为集群实际代理地址）
git config --global http.proxy http://proxy.example.com:8080
# 设置HTTPS代理
git config --global https.proxy https://proxy.example.com:8080
# 若无需代理，清除残留配置
git config --global --unset http.proxy
git config --global --unset https.proxy

4. 切换为SSH协议克隆

HTTP协议在受限网络中稳定性差，改用SSH协议（需提前在GitHub配置HPC节点的SSH公钥）：

git clone git@github.com:<用户名>/<仓库名>.git

5. 调整Git缓冲区至合理值

过大的http.postBuffer可能触发环境限制，尝试设置为1GB：

git config --global http.postBuffer 1073741824

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