如何解决VS Code中拉取GitLab分支时的Git Recv failure错误？
2026-8-22
解决Git拉取GitLab仓库时的"Recv failure: Connection was reset"错误
检查网络连通性
- 执行
ping gitlab.com测试能否连通GitLab服务器，若丢包严重或完全不通，排查本地防火墙、路由器设置，或切换网络环境（比如用手机热点）。 - 用
curl -v https://gitlab.com/abc/xyz/查看连接过程的详细日志，定位是DNS解析、握手还是传输阶段出问题。
- 执行
重置Git代理配置
- 先查看当前代理设置：
git config --global --get http.proxy和git config --global --get https.proxy - 若存在未生效或错误的代理，执行
git config --global --unset http.proxy和git config --global --unset https.proxy清除。 - 若需要代理访问，确认代理地址、端口无误后重新设置：
git config --global https.proxy http://your-proxy-address:port
- 先查看当前代理设置：
切换远程仓库协议为SSH
- HTTPS协议容易受网络环境影响出现连接重置，换成SSH更稳定。先查看当前远程地址：
git remote -v - 执行
git remote set-url origin git@gitlab.com:abc/xyz.git替换为SSH地址。 - 确保本地SSH公钥已添加到GitLab账户的SSH Keys列表中（GitLab个人设置→SSH Keys）。
- HTTPS协议容易受网络环境影响出现连接重置，换成SSH更稳定。先查看当前远程地址：
清理Git缓存与临时调整SSL设置
- 清除HTTP凭证缓存：
git config --global --unset credential.helper - 临时关闭SSL验证测试是否为证书问题：
git config --global http.sslVerify false（问题解决后建议重新开启：git config --global http.sslVerify true） - 若以上都无效，尝试重新克隆仓库：
git clone git@gitlab.com:abc/xyz.git
- 清除HTTP凭证缓存：
更新Git版本
- 老版本Git可能存在网络协议兼容性问题，执行
git --version查看当前版本，若版本较旧（比如低于2.20），更新到最新稳定版。
- 老版本Git可能存在网络协议兼容性问题，执行
内容的提问来源于stack exchange，提问作者ndb
相关产品推荐
相关产品推荐
