本地Git仓库推送至GitHub时报RPC failed错误求助

核心原因 #

• 单批次推送内容体积过大：本次推送总数据量达3.34GiB，远超Git默认的HTTP传输缓存限制
• 网络传输中断：SSL连接被重置，触发系统10054错误，远端服务主动中断连接

解决方案（按优先级依次尝试） #

• 调整Git HTTP传输缓存上限
  执行以下命令将缓存上限调整为500M：
  git config --global http.postBuffer 524288000
  如果仍报错可继续上调到1G：
  git config --global http.postBuffer 1073741824
• 改用SSH协议推送
  先在GitHub账户中配置本地SSH公钥，再修改本地仓库的远程地址协议：

# 查看当前远程地址
git remote -v
# 修改为SSH协议地址，替换为你自己的用户名和仓库名
git remote set-url origin git@github.com:你的用户名/你的仓库名.git

修改完成后重新执行推送命令即可。

• 分批次推送提交
  不要一次性推送所有分支，先推送单个主分支：
  git push origin main
  主分支推送完成后再依次推送其他分支，降低单批次传输的数据量。
• 清理超限大文件
  GitHub单文件最大允许100M，超过限制会直接拦截推送。执行以下命令查看仓库内最大的20个文件：
  git ls-files | xargs ls -lh | sort -k5 -hr | head -n20
  如果存在超过100M的文件，可以添加到.gitignore忽略，或者使用Git LFS存储大文件。
• 临时关闭SSL校验（仅临时测试使用，不建议长期开启）
  如果是本地网络SSL证书校验导致的中断，可以临时关闭校验：
  git config --global http.sslVerify false
  推送完成后建议执行git config --global http.sslVerify true恢复校验，避免安全风险。

如果以上方案都无效，可以尝试切换网络环境（比如切换手机热点）后再推送，排除本地网络波动的影响。

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