使用VS Code部署React应用到GitHub时遇推送错误如何解决？

报错详情 #

原始报错：

error: RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly: CANCEL (err 8)
send-pack: unexpected disconnect while reading sideband packet
fatal: the remote end hung up unexpectedly
Everything up-to-date

中文翻译：
错误：RPC调用失败；curl 92 HTTP/2流0未正常关闭：取消（错误码8）
send-pack：读取边带数据包时意外断开连接
致命错误：远端意外挂断
所有内容均为最新

触发原因 #

该报错一般由Git缓冲区配置过小、HTTP/2协议兼容问题、项目包含未忽略的大文件、网络波动四类原因导致。

修复步骤 #

按优先级依次尝试以下操作即可：

• 调整Git POST缓冲区大小
  执行命令将单次推送最大字节数调整为500M，适配React项目打包后的体积：
  git config --global http.postBuffer 524288000
  仅需对当前项目生效时，删除命令中的--global参数即可。
• 强制使用HTTP/1.1协议推送
  部分网络环境对HTTP/2的支持存在兼容问题，执行命令切换协议：
  git config --global http.version HTTP/1.1
• 清理未忽略的大文件
  检查.gitignore配置，确保已添加node_modules、build等无需提交的大体积目录规则，清理已经错误提交的大文件后再重试推送。
• 拆分提交推送
  首次推送全量项目时如果提交记录过多，可先推送部分提交再推送全量：
  先执行git log取前几条提交的哈希值，执行git push origin [提交哈希值]:main推送部分内容，成功后再执行git push origin main全量推送。
• 切换网络环境
  关闭代理、重启路由器或者切换手机热点后重试，排除运营商网络限制、代理波动导致的推送失败。

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