Bootstrap

解决 Git SSL 连接错误:OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno

问题描述

在执行 git pull 命令时遇到以下错误:

> git pull --tags origin main
fatal: unable to access 'github仓库': OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 0

这个错误通常表示 Git 在尝试通过 HTTPS 连接到 GitHub 时遇到了 SSL 连接问题。

解决方案

1. 检查网络连接

首先,确保你的网络连接正常:

# 测试与 GitHub 的连接
ping github.com

2. 禁用 SSL 验证

如果网络正常但仍然无法连接,可以尝试禁用 SSL 验证:

git config --global http.sslVerify "false"

3. 更新 Git 凭据

重置并更新你的 Git 凭据:

# 移除系统级凭据
git config --system --unset credential.helper

# 设置全局凭据管理器
git config --global credential.helper manager

4. 代理设置

如果你使用代理服务器:

# 设置代理
git config --global http.proxy http://proxyserver:port

# 取消代理设置
git config --global --unset http.proxy

5. 更新 SSL 证书设置

重新配置 SSL 后端和证书:

git config --global http.sslBackend openssl
git config --global http.sslCAInfo /path/to/ca-bundle.crt

6. 切换到 SSH 连接

如果 HTTPS 持续出现问题,可以考虑使用 SSH:

# 1. 生成 SSH 密钥
ssh-keygen -t rsa -b 4096 -C "[email protected]"

# 2. 更改仓库远程 URL
git remote set-url origin [email protected]:username/repository.git

临时解决方案

有时这只是临时的网络问题,可以尝试:

# 多次尝试
git pull --tags origin main
;