git 推送出现 “fatal: The remote end hung up unexpectedly“ 解决方案

最新推荐文章于 2025-09-25 19:04:46 发布

原创最新推荐文章于 2025-09-25 19:04:46 发布 · 1.3w 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#git #大文件

git 专栏收录该内容

5 篇文章

订阅专栏

本文介绍了使用Git LFS解决向GitLab推送大文件时遇到的卡死或错误问题的方法，包括客户端配置调整及服务端大小限制修改。

https://blog.youkuaiyun.com/qq_41241767/article/details/98181952 git 推送出现 "fatal: The remote end hung up unexpectedly" 解决方案

https://blog.youkuaiyun.com/weixin_34221775/article/details/89549235 解决gitlab限制上传大小文件的问题

https://www.oschina.net/translate/getting-started-with-git-lfs-tutorial Git LFS 入门指南

https://blog.youkuaiyun.com/jjjjjj123321/article/details/84890893 使用Git LFS上传大文件到GitHub教程，以及可能会遇到的坑（使用了Git LFS却依然传不上超过100M的文件；framework库如何添加等）

问题：

使用git或者TortosieGit向Gitlab推送大文件时，会卡死或者报错”fatal: The remote end hung up unexpectedly“

解决：

使用git-lfs上传大文件依然失败：

正常使用git lfs上传结果如下：

唯一的有疑问的地方是git lfs ls-files查询没有结果，但文件.gitattributes中有，原因如下：

修改后，git lfs ls-files查询有结果了，但在push的过程中又遇到Client error... from HTTP 413

这个413错误的意思很明显，就是push的内容过大，需要从两方面解决：

客户端

在克隆/创建版本库生成的 .git目录下面修改生成的config文件增加如下：

[user]
    name = your name
    email = your email
[credential]
    helper = manager-core
[http] 
    postBuffer = 1073741824  # 1G
[filter "lfs"]
    process = git-lfs filter-process
    required = true
    clean = git-lfs clean -- %f
    smudge = git-lfs smudge -- %f
[https]
    postBuffer = 1073741824  # 1G

重新推送即可。

或者设置缓存：

$ git config http.postBuffer 1073741824
$ git config https.postBuffer 1073741824

gitlab服务端

调整服务端那边的大小限制，因为gitlab服务端走nginx，那在nginx的配置文件里对client_max_body_size这个字段进行设置，大小要大于你项目的大小

再次push上传，OK

git-lfs介绍：

1、使用 LFS : 有效的处理大文件

   LFS 并不能像"变魔术一样"处理所有的大型数据：它需要记录并保存每一个变化。然而，这就把负担转移给了远程服务器 - 允许本地仓库保持相对的精简。

   为了实现这个可能，LFS 耍了一个小把戏：它在本地仓库中并不保留所有的文件版本，而是仅根据需要提供检出版本中必需的文件。

   但这引发了一个有意思的问题：如果这些庞大的文件本身没有出现在你的本地仓库中....改用什么来代替呢? LFS 保存轻量级指针中有真实的文件数据。当你用一个这样的指针去迁出一个修订版时，LFS 会很轻易地找到源文件（不在他上面可能就在服务器上，特殊缓存）然后你下载就行了。

   因此，你最终只会得到你真正想要的文件 - 而不是一些你可能永远都不需要冗余数据。

2、安装 LFS

   LFS 尚未加入 Git 的核心二进制文件，但是它可以作为扩展使用。这意味着，使用之前我们需要提前安装。

服务端：

   目前并不是所有主机服务器都支持 LFS。但如果你是 GitLab 用户就不必担心。如果你使用 GitLab.com 或 GitLab CE 或 EE 的中间版本，它们已经支持LFS了! 您的 管理员只需要开启LFS选项。

本地机器：

   你本地安装的 Git 也需要支持 LFS。如果你使用 Tower，一个 Git 桌面客户端，你就不需要额外安装了，因为 Tower 已经非常好地支持 Git 大文件系统。

   如果你使用命令行来运行 Git，可以选择以下方法来安装 LFS：

二进制安装包：最新版本的 binary packages，支持 Windows，Mac，Linux 以及 FreeBSD

Linux：Debian 和 RPM 的软件包可从 PackageCloud 获得。

macOS：你可以使用 Homebrew 执行“brew install git-lfs”来安装，也可以使用 MacPorts 执行“port install git-lfs”安装.

Windows：你可以使用包管理器 Chocolatey 执行“choco install git-lfs”来安装。

   等你的包管理器完成上述安装后，你还需要执行“ git lfs install”命令：



3、使用 LFS 追踪文件

   没有特别说明的情况下，LFS 不会处理大文件问题，因此，我们必须明确告诉 LFS 该处理哪些文件。

   让我们回到“大 Photoshop 文件”的示例，我们可以使用“ git lfs track”命令来告诉 LFS 处理“design.psd”文件：
git lfs track "design-resources/design.psd"
项目根目录下新建了一个新文件 ".gitattributes" （如果已存在，将会被修改）， ".gitattributes" 文件记录了我们用 LFS 追踪的所有的文件路径。
cat .gitattributes
design-resources/design.psd filter=lfs diff=lfs merge=lfs -text
在这之后 LFS 会处理这个文件。我们接下来只要像往常那样把这个文件提交到仓库。值得注意的是， ".gitattributes" 文件也需要提交到仓库，操作和提交其他修改文件一样：
git add .gitattributes
git add design-resources/design.psd
git commit -m "Add design file"
git push
追踪文件路径：

添加单一文件如上所示就可以。但是，比如说，如果你想追踪项目里所有后缀名为 indd 的文件呢？放心，你不用手动的添加每个文件。LFS 允许你定义文件路径，就像忽略文件时的用法那样。举个例子，下面的命令会告诉 LFS 追踪所有的 InDesign 文件 — 已经存在的和以后添加的。
git lfs track "*.indd"
你也可以告诉 LFS 追踪整个文件夹里的所有内容：
git lfs track "design-assets/*"
追踪文件概述：

想知道到底有哪些文件在被 LFS 追踪。你可以简单的看看 .gitattributes文件。然而，它们不是真实的文件，而是包含一些规则和理论的文件：某些文件可能会漏掉，例如由于拼写错误或者过分严格的规则。

想要查看你当前正在追踪的实际文件的列表，可以使用 git lfs ls-files 命令：
git lfs ls-files
194dcdb603 * design-resources/design.psd