Git 故障排查 (BASIC ALL)

有时事情并没有像原本应该的那样工作,或者如你所期望的那样你正在使用 Git。以下是有关 Git 使用的故障排除和解决问题的一些提示。

git push Broken pipe 错误

尝试推送到远程存储库时可能会发生 “Broken pip” 错误。推送时,您通常会看到:

Write failed: Broken pipe
fatal: The remote end hung up unexpectedly

为了解决这个问题,这里有一些可能的解决方案。

增加 Git 中的 POST 缓冲区大小

如果您使用 Git over HTTP 而不是 SSH,您可以尝试增加 Git 中的 POST 缓冲区大小配置。

克隆期间的错误示例: fatal: pack has bad object at offset XXXXXXXXX: inflate returned -5

打开终端并输入:

git config http.postBuffer 52428800

该值以字节为单位,因此在上述情况下,缓冲区大小已设置为 50MB。默认值为 1MB。

检查您的 SSH 配置

如果通过 SSH 推送,首先检查您的 SSH 配置,因为 “Broken pipe” 错误有时是由 SSH 的潜在问题引起的(例如验证)。

如果您是具有服务器访问权限的管理员,您还可以通过在客户端或服务器上配置 SSH keep-alive 来防止会话超时。

note不需要同时配置客户端和服务器。

要在客户端配置 SSH

  • 在 UNIX 上,编辑 ~/.ssh/config(如果文件不存在则创建该文件)并添加或编辑:

    Host your-gitlab-instance-url.com
      ServerAliveInterval 60
      ServerAliveCountMax 5
    
  • 在 Windows 上,如果您使用 PuTTY,请转到会话属性,然后导航到”连接”并在”发送空数据包以保持会话活动”下,将保持连接之间的秒数(0 表示关闭)设置为 60

要在服务器端配置 SSH,编辑 /etc/ssh/sshd_config 并添加:

ClientAliveInterval 60
ClientAliveCountMax 5

运行 git repack

如果 ‘pack-objects’ 类型错误也被显示,您可以尝试再次推送到远程存储库之前运行git repack

git repack
git push

升级您的 Git 客户端

如果您运行的是旧版本的 Git(< 2.9),请考虑升级到 >= 2.9(请参阅推送到 Git 仓库时 pipe 损坏)。

ssh_exchange_identification 错误

用户在尝试通过 Git over SSH 推送或拉取时可能会遇到以下错误:

Please make sure you have the correct access rights
and the repository exists.
...
ssh_exchange_identification: read: Connection reset by peer
fatal: Could not read from remote repository.

或者

ssh_exchange_identification: Connection closed by remote host
fatal: The remote end hung up unexpectedly

或者

kex_exchange_identification: Connection closed by remote host
Connection closed by x.x.x.x port 22

这个错误通常表明 SSH 守护进程的 MaxStartups 值正在限制SSH 连接。此设置指定到 SSH 守护程序的最大并发、未经身份验证的连接数。这会影响具有正确身份验证凭据(SSH 密钥)的用户,因为每个连接在开始时都是”未经身份验证”的。默认值为 “10”。

通过添加或修改 /etc/ssh/sshd_config 中的值来增加极狐GitLab 服务器上的 MaxStartups

MaxStartups 100:30:200

100:30:200 表示最多允许 100 个 SSH 会话不受限制,之后 30% 的连接将被丢弃,直到达到 200 的绝对最大值。

配置完成后,重新启动 SSH 守护程序以使更改生效。

# Debian/Ubuntu
sudo systemctl restart ssh

# CentOS/RHEL
sudo service sshd restart

git push / git pull 期间超时

如果从/向您的仓库拉取/推送最终花费超过 50 秒,发出超时。它包含执行的操作数量及其各自计时的日志,如下例所示:

remote: Running checks for branch: master
remote: Scanning for LFS objects... (153ms)
remote: Calculating new repository size... (cancelled after 729ms)

这可用于进一步调查哪些操作性能不佳,并提供有关如何执行的更多信息以改善服务。

git clone over HTTP 失败,抛出 transfer closed with outstanding read data remaining 错误

有时,在克隆旧的或大型仓库时,会抛出以下错误:

error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

这是 Git 本身的常见问题,因为它无法处理大文件或大量文件。Git LFS 就是为了解决这个问题而创建的;然而,即使它也有局限性。这通常是由于以下原因之一:

  • 仓库中的文件数。
  • 历史中的修订次数。
  • 仓库中存在大文件。

根本原因各不相同,因此存在多种可能的解决方案,您可能需要应用多个:

  • 如果在克隆大型仓库时发生此错误,您可以降低克隆深度值为 “1”。例如:

    variables:
      GIT_DEPTH: 1
    
  • 可以增加 http.postBuffer 值从默认的 1 MB 值变为大于仓库大小的值。例如,如果在克隆 500 MB 仓库时 git clone 失败,应该将 http.postBuffer 设置为 524288000

    # Set the http.postBuffer size, in bytes
    git config http.postBuffer 524288000
    
  • 可以在服务器端增加 http.postBuffer

    1. 修改极狐GitLab 实例的 gitlab.rb 文件:

      omnibus_gitconfig['system'] = {
        # Set the http.postBuffer size, in bytes
        "http" => ["postBuffer = 524288000"]
      }
      
    2. 修改后应用配置更改:

      sudo gitlab-ctl reconfigure
      

例如,如果仓库具有很长的历史并且没有大文件,则更改深度应该可以解决问题。但是,如果仓库有非常大的文件,即使深度为 1 也可能太大,因此需要更改 postBuffer。如果增加了本地 postBuffer 但是后端的 NGINX 值仍然太小,错误仍然存在。

修改服务器并不总是一种选择,并且会引入更多潜在风险。首先尝试本地更改。