[Git] fatal: the remote end hung up unexpectedly

1 问题介绍

在使用Git进行代码管理和版本控制的过程中，许多开发者可能会遇到这样一个错误提示：fatal: the remote end hung up unexpectedly。这是一种常见的错误，通常出现在将本地代码推送（push）到远程仓库（如GitHub、GitLab或Bitbucket）时。理解这个错误的根本原因并采取相应的解决措施是提高开发效率的关键。下面我们将详细分析这个错误的原因及其解决方法。

2 错误的可能原因

• 网络连接问题
  • 在推送过程中，网络连接中断或不稳定可能会导致这个错误。
  • 如果网络连接较慢，推送数据包可能会超过远程服务器的超时设置，从而导致连接中断。
• 远程服务器配置问题
  • 如果远程仓库所在的服务器存储空间不足，也可能导致推送失败。
  • 如果一次性推送的数据量过大（例如，推送大文件或大量提交记录），可能会超过服务器的处理能力，从而中断连接。
• 本地 Git 配置问题
  • Git的默认缓冲区大小可能不足以处理大规模推送操作，导致错误发生。

3 问题解决

首先排查以下两个常见情况：

• 先检查自身网络状况，例如网络是否顺畅，是不是应该爬墙
• 查看远程仓库容量是否不足（一般无需排查）

不是以上两种情况一般就是 Git 缓冲区配置出现问题了。执行以下命令打开 Git 配置文件：

# 进入项目目录
cd /path/to/repo# 打开 Git 配置文件
vim .git/config

打开后如下图，正常情况下只有蓝色方框的内容，没有红色方框的内容

接下来在文件的最后一行追加红色方框的内容，内容如下：

[http]postBuffer = 524288000

保存文件并退出后，重新 push 你的代码

git push