error: RPC failed； curl 18 transfer closed with outstanding read

原创已于 2025-04-05 22:38:48 修改 · 760 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#git

于 2022-03-09 19:26:56 首次发布

日常专栏收录该内容

468 篇文章

订阅专栏

在尝试拉取或推送Git仓库时遇到了错误，包括'RPC failed; curl 18 transfer closed without outstanding read data remaining'，'Theremote end hung up unexpectedly'和'index-pack failed'。这通常由于HTTP缓冲区大小不足或网络问题引起。解决方案是通过运行'git config --global http.postBuffer 524288000'来增大缓冲区大小。确保网络连接稳定并重新尝试操作。

Git大文件传输失败？手把手解决「RPC failed; curl 18」错误

在使用Git进行版本控制时，你是否遇到过以下错误？

error: RPC failed; curl 18 transfer closed with outstanding read data remaining 
fatal: The remote end hung up unexpectedly 
fatal: early EOF 
fatal: index-pack failed

这些错误通常发生在推送或拉取大文件（如代码、图片、模型文件）时，由于Git的默认传输限制或网络问题导致。本文将详细解析问题原因，并提供快速解决方案。

1. 错误现象与原因

1.1 错误现象

当你尝试通过 git push 或 git pull 传输大文件时，Git会报错并中断传输，提示：

error: RPC failed; curl 18 transfer closed with outstanding read data remaining 
fatal: The remote end hung up unexpectedly 
fatal: early EOF 
fatal: index-pack failed

1.2 核心原因

传输数据量过大：Git默认的HTTP传输缓冲区大小有限（默认为1MB），当单个文件超过该限制时，传输会中断。
网络不稳定：网络波动导致传输过程中断。
服务器配置限制：远程仓库（如GitHub、GitLab）可能对单次传输大小有限制。

2. 解决方案：调整Git传输缓冲区

2.1 方法一：增大 `http.postBuffer`

通过修改Git的全局配置，增大HTTP传输缓冲区，使其支持大文件传输。

步骤1：设置缓冲区大小

git config --global http.postBuffer 524288000

参数解释：
- 524288000 表示缓冲区大小为 512MB（524288000 = 512 * 1024 * 1024）。
- 可根据需要调整为更大的值（如 1048576000 对应 1GB）。

步骤2：验证配置

git config --get http.postBuffer

如果输出 524288000，说明配置成功。

步骤3：重新推送

git push origin <branch-name>

2.2 方法二：使用SSH协议替代HTTP

HTTP协议对传输大小限制严格，改用SSH协议可绕过部分限制。

步骤1：生成SSH密钥（若未配置）

ssh-keygen -t ed25519 -C "your_email@example.com"

步骤2：将公钥添加到Git仓库平台

登录GitHub/GitLab，将生成的公钥（~/.ssh/id_ed25519.pub）添加到SSH Keys。

步骤3：切换仓库为SSH协议

git remote set-url origin git@github.com:username/repository.git

步骤4：重新推送

git push origin <branch-name>

3. 其他解决方案

3.1 分割大文件

如果文件过大（如超过500MB），建议：

拆分文件：使用工具（如 split）将文件分割为小块。

使用LFS（Large File Storage）：

git lfs install
git lfs track "*.extension"  # 替换为文件类型，如".png"
git add .gitattributes
git commit -m "Track large files with LFS"
git push

3.2 检查网络连接

关闭后台占用带宽的程序（如下载工具）。
尝试使用更稳定的网络环境。

3.3 联系仓库管理员

如果问题持续存在，可能是远程仓库的服务器配置或存储限制导致，需联系管理员调整设置。

4. 预防措施

避免直接提交大文件：
- 使用.gitignore排除大文件（如*.mp4、*.zip）。

定期清理仓库：

git filter-repo --strip-blobs-bigger-than 100M  # 移除超过100MB的文件

使用Git LFS管理大文件：
```
git lfs install  # 全局安装
```

5. 常见问题解答

Q：修改配置后依然失败？

检查配置是否生效：使用 git config --global --list 确认 http.postBuffer 是否正确。
尝试更大的缓冲区：将 http.postBuffer 设为 1048576000（1GB）。

Q：SSH推送失败怎么办？

检查SSH连接：

ssh -T git@github.com  # 测试GitHub连接

更新SSH密钥：确保公钥已正确添加到Git平台。

6. 总结

通过调整Git的 http.postBuffer 或改用SSH协议，可轻松解决大文件传输问题。若问题仍存在，需结合网络环境、文件管理策略进一步优化。掌握这些技巧后，你将能更高效地使用Git处理复杂项目！

附录：命令速查表

问题描述	解决命令
设置传输缓冲区	`git config --global http.postBuffer 524288000`
验证配置	`git config --get http.postBuffer`
切换SSH协议	`git remote set-url origin git@github.com:username/repo.git`
安装Git LFS	`git lfs install`

Git官方文档：Git Large File Storage (LFS)

通过本文的步骤，你将轻松解决Git大文件传输问题，告别恼人的传输中断！

error: RPC failed; curl 18 transfer closed with outstanding read data remaining 
fatal: The remote end hung up unexpectedly 
fatal: early EOF 
fatal: index-pack failed

git config –-global http.postBuffer 524288000
git config –-list