Git通过SSH操作远程仓库首次失败、二次成功的问题排查求助

1. 调整SSH连接存活配置 #

编辑本地SSH配置文件（Linux/macOS路径为~/.ssh/config，Windows为C:\Users\<你的用户名>\.ssh\config，无文件则新建），添加针对GitHub的持久化参数：

Host github.com
    HostName github.com
    User git
    ServerAliveInterval 30
    ServerAliveCountMax 3
    TCPKeepAlive yes

这些参数会让SSH定期发送心跳包，避免闲置连接被网络设备回收，从根源减少首次连接失效的概率。

2. 排查网络设备的闲置回收机制 #

很多家用路由器、防火墙（包括系统自带防火墙和第三方安全软件）会自动断开长时间无数据的TCP连接，导致隔一段时间后首次SSH请求时旧连接已被销毁，第二次请求才会重新建立有效连接：

• 进入路由器管理后台，找到“连接超时”“闲置连接回收”类选项，延长超时时间（比如设为24小时以上）或直接关闭该功能。
• 检查第三方安全软件的网络规则，确保没有自动阻断闲置的SSH连接。

3. 抓取SSH连接日志定位问题 #

手动执行两次ssh -vT git@github.com，对比两次的输出日志：

• 第一次失败时重点看TCP连接阶段的报错，确认是连接被主动断开，还是密钥验证环节出问题。
• 第二次成功时查看完整的连接流程，对比两次日志的差异点，快速定位是网络层面还是认证层面的问题。
  也可以用nc -zv github.com 22测试端口连通性，连续执行两次，看首次请求是否存在超时或断开的情况。

4. 修复DNS解析不稳定问题 #

部分场景下，首次DNS解析返回的GitHub CDN IP可能存在连通性问题，第二次解析会拿到可用IP。可以手动指定稳定IP到hosts文件：

• 先通过ping github.com或nslookup github.com获取一个稳定的GitHub IP。
• 编辑/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows），添加一行：

  140.82.113.3 github.com
  

注意：GitHub的IP可能会更新，后续如果问题复发需要重新获取最新IP。

5. 检查SSH密钥的缓存状态 #

如果ssh-agent没有自动加载密钥，首次操作时可能会因为密钥未就绪失败，第二次操作触发了密钥加载：

• 执行ssh-add -l查看当前已加载的密钥列表，如果看不到你的GitHub密钥，执行ssh-add ~/.ssh/你的密钥文件名手动加载。
• 可以在shell的配置文件（.bashrc/.zshrc）中添加自动加载命令：ssh-add ~/.ssh/你的密钥文件名 > /dev/null 2>&1，避免每次手动加载。

6. 排查代理/VPN的就绪问题 #

如果使用了代理或VPN，首次请求时代理可能未完全就绪，导致连接失败，第二次请求时代理已正常工作：

• 关闭代理/VPN后测试操作是否正常，确认是否是代理导致的问题。
• 调整代理的连接超时设置，确保代理在首次请求时就能快速响应。

内容的提问来源于stack exchange，提问作者zing