Git：fatal: the remote end hung up unexpectedly问题解决

“fatal: the remote end hung up unexpectedly” 是一个常见的Git错误，通常出现在推送或拉取代码时。这个错误可能由多种原因引起，包括网络问题、配置问题、文件大小过大或远程服务器的限制等。以下将根据资料，详细分析该错误的可能原因及解决方法。

一、错误原因分析

1. 网络问题

   • 网络连接不稳定是导致此错误最常见的原因之一。例如，无线网络连接可能不如有线网络稳定，因此建议切换到更稳定的网络连接。
   • 如果是由于网络限制（如“墙”）导致的，可以尝试使用代理或VPN来解决。

2. 提交缓存区大小不足

   • 当Git尝试推送的文件较大，而提交缓存区的大小不足时，会导致此错误。例如，推送的文件超过了缓存区的大小限制，需要调整缓存区大小。
   • 修改命令：git config --global http.postBuffer 524288000（设置为500MB）或更大的值。

3. 远程服务器问题

   • 远程仓库服务器可能因为某些原因提前关闭连接，例如服务器配置问题或资源限制。例如，HTTP 413错误表明服务器无法处理请求，这可能是由于请求的大小超过了服务器的限制。
   • 在某些情况下，服务器可能因为安全策略（如禁用SHA-1签名）导致连接失败，需要更新客户端或更改密钥类型。

4. TLS协议问题

   • TLS协议错误也可能导致此错误。例如，GnuTLS报告了一个意外的TLS数据包长度，这可能是由于网络问题或证书问题。

5. 文件大小过大

   • 如果推送的文件过大，而远程仓库的限制较小，也可能导致此错误。例如，推送的文件大小超过了远程仓库的限制，需要减小文件大小或调整仓库配置。

6. HTTP/HTTPS协议问题

   • 使用HTTP协议时，可能会遇到HTTP错误，例如HTTP 401（未授权）或403（禁止访问）。

7. SSH协议问题

   • 使用SSH协议时，如果远程服务器配置错误，也可能导致连接失败。

二、解决方法

针对上述原因，以下是一些可能的解决方案：

1. 检查网络连接

   • 确保网络连接稳定，如果可能，使用有线网络代替无线网络。
   • 如果是由于网络限制（如“墙”），可以尝试使用代理或VPN。

2. 调整提交缓存区大小

   • 修改命令：git config --global http.postBuffer 524288000（设置为500MB或更大）。
   • 如果问题仍然存在，可以尝试增加更大的缓存区大小，例如：git config --global http.postBuffer 157286400。

3. 调整文件大小

   • 如果推送的文件过大，可以尝试将文件分割成较小的块，或者使用压缩工具（如gzip）减小文件大小。

4. 切换到HTTPS协议

   • 如果使用SSH协议失败，可以尝试切换到HTTPS协议。例如，使用命令：git remote set-url origin [https://github.com/username/repository.git ](https://github.com/username/repository.git )。

5. 解决TLS协议问题

   • 确保客户端和服务器的TLS版本兼容。例如，如果服务器使用的是旧版本的TLS协议，可以尝试更新客户端或更改密钥类型。

6. 处理HTTP/HTTPS错误

   • 如果遇到HTTP 401或403错误，可以尝试检查认证信息是否正确，或者联系服务器管理员解决权限问题。

7. 使用SSH协议

   • 如果问题出在SSH协议上，可以尝试重新配置SSH密钥或使用其他SSH客户端。

8. 重试操作

   • 有时，简单的重试操作也能解决问题。例如，重新执行git push或git pull命令。

9. 更新Git版本

   • 如果问题持续存在，可以尝试更新到最新版本的Git，以确保兼容性和安全性。

三、总结

“fatal: the remote end hung up unexpectedly” 错误可能由多种原因引起，包括网络问题、提交缓存区大小不足、文件大小过大、TLS协议问题、HTTP/HTTPS错误等。解决此问题需要根据具体原因采取相应的措施，例如检查网络连接、调整缓存区大小、减小文件大小或切换到HTTPS协议等。如果问题仍然无法解决，建议联系远程仓库管理员或寻求进一步的技术支持。

【还有一种情况比较坑的：在使用公司gitlab的时候通过url导入其他地址的项目，然后因为项目内容过大导致失败，然后就会给你创建一个空项目，空就空嘛，你以为就是一个单纯的空项目，然后想把本地的项目push上来，死活都不行，一直报the remote end hung up unexpectedly问题，设置缓存大小也不行。然后拉代码也不行，也会报同样错误。奔溃。。。问题就是这个空项目，已经是有问题的了，需要删除了，再新建一个空白项目，再将本地的项目推上来，记得加缓存大小】