彻底解决 WSL 启动时的 `getaddrinfo() failed: -5` 错误：网络连通性检测失败深度修复指南

彻底解决 WSL 启动时的 getaddrinfo() failed: -5 错误：网络连通性检测失败深度修复指南

适用环境：Windows 10/11 + WSL2 + Ubuntu 24.04 及其他 Linux 发行版
关键词：WSL 网络错误 · DNS 解析失败 · msftconnecttest · getaddrinfo · Linux 教程

1. 问题现象与根本原因

1.1 典型错误日志

每次启动 WSL 时，终端会输出类似以下的冗余信息：

DESKTOP-KQBTVBF login: CheckConnection: resolving the name www.msftconnecttest.com [AF_INET]
CheckConnection: connecting to 23.202.34.233
CheckConnection: resolving the name www.msftconnecttest.com [AF_INET6]
CheckConnection: arming select for 5 seconds
CheckConnection: v4 succeeded
CheckConnection: returning v4 (1) v6 (2)
[    7.277267] WSL (389) ERROR: CheckConnection: getaddrinfo() failed: -5

尽管系统仍可登录使用，但该错误不仅影响启动体验，还可能暗示 WSL 内部网络配置异常，导致部分依赖域名解析的服务（如 apt update、curl、git）间歇性失败。

1.2 错误码含义

Windows 的 网络连接状态指示器 (NCSI) 会向 www.msftconnecttest.com 发送请求以判断互联网连通性。WSL 继承了这一机制，但因其网络栈独立于 Windows，容易出现 DNS 解析失败。

1.3 常见触发场景

• WSL 自动生成的 /etc/resolv.conf 中 nameserver 指向无效地址（如 10.255.255.254 无法转发查询）。
• Windows 主机 DNS 配置异常（例如使用 VPN、手动设置了错误的 DNS）。
• 代理/VPN 环境未在 WSL 中同步配置。
• WSL1 与 WSL2 网络模型差异导致的兼容性问题。

2. 问题排查决策流程图

以下流程图可帮助你快速定位适合自己的修复路径：

flowchart TD
    A[启动WSL出现getaddrinfo错误] --> B{cat /etc/resolv.conf}
    B -->|nameserver 为 10.255.255.254 或 空| C[DNS转发异常]
    B -->|nameserver 为 8.8.8.8 等公共DNS| D[Windows主机或代理问题]
    C --> E[方案1: 永久固定DNS]
    E --> F[修改 /etc/wsl.conf 并手动设置resolv.conf]
    D --> G{Windows能否ping通 www.msftconnecttest.com?}
    G -->|能| H[检查WSL网络模式与防火墙]
    G -->|不能| I[修复Windows DNS/代理]
    F & H & I --> J[重启WSL: wsl --shutdown]
    J --> K[错误是否消失?]
    K -->|是| L[✅ 问题解决]
    K -->|否| M[进阶方案: 禁用NCSI或重置WSL网络]

3. 五种修复方案对比（建议优先尝试方案一）

4. 详细操作步骤

4.1 方案一：永久固定 WSL 内部 DNS（最有效）

4.1.1 阻止 WSL 自动生成 resolv.conf

WSL 每次启动时会覆盖 /etc/resolv.conf，我们需要通过 /etc/wsl.conf 禁用该行为。

sudo nano /etc/wsl.conf

粘贴以下内容：

[network]
generateResolvConf = false

保存（Ctrl+O，回车）并退出（Ctrl+X）。

4.1.2 手动创建可靠的 resolv.conf

删除原有的符号链接或文件，并新建：

sudo rm /etc/resolv.conf
sudo nano /etc/resolv.conf

写入以下 DNS 服务器（首选 Google 和 Cloudflare）：

nameserver 8.8.8.8
nameserver 1.1.1.1

保存退出。

4.1.3 完全重启 WSL

在 Windows 管理员 PowerShell 中执行：

wsl --shutdown

然后重新打开 WSL 终端。错误信息应不再出现。

验证：运行 ping -c 3 www.msftconnecttest.com，若能正常返回数据包，说明修复成功。

4.2 方案二：检查并修复 Windows 主机 DNS

如果方案一无效，说明问题可能出在 Windows 本身。

4.2.1 刷新 DNS 缓存并重置网络栈

以管理员身份打开 PowerShell，依次执行：

ipconfig /flushdns
netsh winsock reset
netsh int ip reset all
netsh winhttp reset proxy

重启计算机后重新测试 WSL。

4.2.2 手动指定主机 DNS

1. 打开 控制面板 → 网络和共享中心 → 更改适配器设置。
2. 右键当前使用的网络（以太网或 WLAN）→ 属性。
3. 双击 Internet 协议版本 4 (TCP/IPv4)。

4. 选择 使用下面的 DNS 服务器地址，填入：

   • 首选 DNS：8.8.8.8
   • 备用 DNS：1.1.1.1
5. 点击确定，重启 WSL。

4.3 方案三：在代理/VPN 环境下配置 WSL 代理

若你使用公司 VPN 或 Clash/V2Ray 等代理工具，WSL 无法自动继承代理设置。

4.3.1 获取 Windows 主机 IP

在 WSL 中执行：

cat /etc/resolv.conf | grep nameserver | awk '{print $2}'

通常输出类似 172.24.80.1 的地址（记作 host_ip）。

4.3.2 设置代理环境变量

临时生效（当前会话）：

export http_proxy="http://${host_ip}:7890"
export https_proxy="http://${host_ip}:7890"

请将 7890 替换为你的代理软件实际 HTTP 端口（如 Clash 默认 7890，V2Ray 默认 10809）。

永久生效：将上述命令追加到 ~/.bashrc 或 ~/.zshrc：

echo 'export http_proxy="http://172.24.80.1:7890"' >> ~/.bashrc
echo 'export https_proxy="http://172.24.80.1:7890"' >> ~/.bashrc
source ~/.bashrc

4.4 方案四：启用 WSL2 镜像网络与 DNS 隧道

WSL2 的 mirrored 网络模式可以使 WSL 与 Windows 共享完全相同的网络接口，有效解决 DNS 转发异常。

4.4.1 编辑 .wslconfig

在 Windows 用户目录下创建或编辑 %UserProfile%\.wslconfig：

notepad "$env:UserProfile\.wslconfig"

粘贴以下内容：

[wsl2]
networkingMode=mirrored
dnsTunneling=true
firewall=false
autoProxy=true

4.4.2 重启 WSL 并验证

wsl --shutdown

重新进入 WSL，检查 /etc/resolv.conf 是否已自动变为 Windows 主机 DNS。错误应消失。

4.5 方案五：彻底禁用 Windows NCSI 检测（备选）

⚠️ 注意：此操作会关闭 Windows 任务栏网络图标的“Internet 访问”检测，但不会影响实际上网功能。

4.5.1 修改注册表

1. 按 Win + R，输入 regedit 并回车。

2. 定位到：

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NlaSvc\Parameters\Internet

3. 双击右侧的 EnableActiveProbing，将数值数据从 1 改为 0。
4. 重启计算机。

此后 WSL 将不再尝试连接 www.msftconnecttest.com，错误自然消除。

5. 验证与后续优化

5.1 快速验证命令

# 测试域名解析
dig www.msftconnecttest.com +short
# 或
nslookup www.msftconnecttest.com

# 测试连通性
curl -I http://www.msftconnecttest.com

所有命令均应返回正常响应，无 getaddrinfo 报错。

5.2 预防该问题复发的最佳实践

• 保持 WSL2 为默认版本：wsl --set-default-version 2
• 定期清理 DNS 缓存：在 Windows 计划任务中定期执行 ipconfig /flushdns
• 使用镜像网络模式（方案四）可一劳永逸避免此类 DNS 问题。
• 避免手动修改 /etc/resolv.conf 而不禁用自动生成，否则每次重启都会重置。

6. 总结

本文提供的五种方案覆盖了从初级到高级、从软件配置到系统底层的修复手段。绝大多数用户只需执行 方案一（3 条命令） 即可彻底解决问题。如果你的环境较为复杂（如 VPN、企业网络），请结合方案三或方案四。

最后建议：若错误依然存在，请在 WSL 中执行 wsl --version 确保版本 ≥ 2.0.0，并更新 Windows 系统至最新版本。WSL 团队在后续版本中已优化了 DNS 隧道逻辑。

延伸阅读

• 微软官方文档：WSL 网络配置
• 解决 WSL 中 Temporary failure in name resolution 的通用方法