WSL2中Git pull偶尔失败：ssh无法解析stash主机名

问题现象 #

在WSL2环境下克隆git@stash仓库后，执行git pull操作偶尔失败，报错信息如下：

ssh: Could not resolve hostname stash: Name or service not known
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

已完成的排查动作：

• WSL2内可正常ping通bitbucket及其他网站，网页访问主机名解析无异常，排除常规DNS问题
• 通过git config -l确认远程仓库配置正确，且尝试用git remote set-url origin <ssh://git@stash:my_server.git>重置远程地址
• 用ssh-add -l验证SSH密钥已添加至代理，service --status-all显示ssh服务正常运行（标记[ + ]）

可能的原因及解决办法 #

1. WSL2网络切换导致DNS配置失效 #

WSL2的网络依赖Windows主机，当Windows切换网络环境（如有线/无线切换），WSL2的DNS配置可能出现短暂异常。

• 手动刷新WSL2的DNS服务：

  sudo systemctl restart systemd-resolved
  

• 或者直接在/etc/hosts中添加stash的IP映射，跳过DNS解析：

  sudo echo "192.168.x.x stash" >> /etc/hosts
  

  替换192.168.x.x为stash服务器的实际IP地址。

2. SSH主机配置错误或缺失 #

检查WSL2的SSH配置文件~/.ssh/config，确认stash的主机配置是否存在或正确：

cat ~/.ssh/config

若未配置，可添加以下内容（按需调整端口、密钥路径）：

Host stash
  HostName stash
  User git
  IdentityFile ~/.ssh/your_private_key_file
  Port 22

确保HostName字段无拼写错误，若服务器使用非默认SSH端口，需修改Port值。

3. 代理服务干扰SSH解析 #

如果Windows或WSL2内启用了全局代理，可能偶尔阻断SSH的主机解析请求。

• 临时关闭代理测试：

  unset http_proxy https_proxy all_proxy
  

  执行后再次尝试git pull，若恢复正常，可在SSH配置中排除stash的代理：
  在~/.ssh/config的Host stash块中添加：

  ProxyCommand none
  

4. Git远程URL格式问题 #

核对远程仓库URL的格式是否正确，避免多余符号或错误端口：

git remote -v

正确的SSH格式应为git@stash:project/repo.git或ssh://git@stash:22/project/repo.git，若服务器使用自定义端口，必须明确指定。

5. WSL2与Windows时间不同步 #

WSL2时间若与Windows主机偏差较大，可能导致SSH握手失败（间接表现为主机解析错误）：

• 同步WSL2系统时间：

  sudo hwclock -s
  

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