罪魁祸首(就我而言): 高时延网络。

这本身不是一个答案，而更多的是一种观察，可以帮助其他人。我发现这个错误偶尔会在高延迟网络上弹出(例如，我必须使用卫星天线上网)。网络的速度很好，但延迟可能很高。注意:问题只存在于某些场景，但我还没有确定是什么模式。

临时缓解: 我换了网络——我换到了一个更慢，但延迟更低的蜂窝网络(我的手机用作热点)——问题消失了。请注意，我只能周期性地这样做，因为我的手机连接也是间歇性的。再加上带宽的使用增加了成本。我也很幸运，我有这样的选择。不是每个人都这样。

我确信在某个地方有一些配置设置使git -或ssh或curl或任何先超时的东西对这样的网络更宽容，但我不知道它是什么。

对开发商的呼吁: 这类问题对农村人口来说是一个持续的问题。当您设计系统、工具和应用程序时，请考虑我们。谢谢你！

如果使用GitHub，在repo目录下，运行此命令设置http。postBuffer似乎是它的最大允许值GitHub:

git config http.postBuffer 2147483648

如果使用git clone克隆一个repo，可以使用相同的选项克隆它:

git clone -c http.postBuffer=2147483648 git@github.com:myuser/myrepo.git /path/to/myrepo

在这两种情况下，上述数字都相当于2 GiB。然而，您可能需要达到这个数量的空闲内存才能使用这个值。

确保每次推送到GitHub都提交不超过这个大小的更改。事实上，为了安全起见，我会将提交推的大小保持在1.8 GiB以下。这可能需要将一个较大的提交划分为较小的提交和推送。

为什么是这个值?

之所以使用这个特定的值，是因为至少在2018年，这个值被记录为GitHub的推送大小限制:

我们不允许超过2GB的推送

为什么不放低一点呢?

一些先前的答案说将其设置为524288000 (500 MiB)，但这个数字似乎是任意的，没有价值。任何较低的值都可以工作，只要您的推送大小不大于设置的值。

为什么不设高一点呢?

如果你将这个值设置为高于2 GiB，并且如果你尝试的推送大小也更高，你可以期待GitHub的文档错误:

远程:致命:包超过允许的最大大小

如果在存储库上缺少写权限，也可能引发此错误。

我的具体案例是这样的:

我用服务器的根用户(通过SSH)创建了一个repo。 我安装了一个git服务，并创建了一个git linux用户，该用户应该管理所有与git相关的操作。 到那时，我已经忘记了这个repo最初是由根用户创建的，而git用户根本没有向存储库中写入任何内容的文件权限。

对我们来说，问题是我们有大量的文件应该由git lfs来管理。

我们采取了以下措施来解决问题:

# Soft reset so you can author a new commit
git reset --soft HEAD~1

# Install git lfs
git lfs install

# Track large files of a specified file type YMMV
git lfs track "*.uasset" "*.umap"

# Re-add everything
git add .

# Author a new commit
git commit -m "git lfs ftw"

# Push
git push

您可能会得到这样的错误

error:不能锁定配置文件。git/config:没有这样的文件或 目录

这是因为你没有本地的。git/config文件。你可以通过下面的命令让它工作:

git config --global http.postBuffer 524288000

这看起来类似于我如何让github默认为ssh，而不是https的新存储库。 也许从http协议切换到ssh协议是值得的:

$ git remote add origin git@github.com:username/project.git