排查适用于 Linux 的 Windows 子系统问题

我们在下面介绍了一些与 WSL 相关的常见故障排除场景，但也请考虑在 GitHub 上的 WSL 产品存储库中搜索已提交的问题。

借助 WSL 产品存储库问题，可进行以下操作：

也可执行以下操作：

安装失败并出现错误 0x80070003

WslRegisterDistribution 失败并出现错误 0x8007019e

安装失败，出现错误 0x80070003 或错误 0x80370102

尝试升级时出错：Invalid command line option: wsl --set-version Ubuntu 2

由于虚拟磁盘系统的某个限制，无法完成所请求的操作。 虚拟硬盘文件必须是解压缩的且未加密的，并且不能是稀疏的。

注意

在我的示例中，我的 Ubuntu 18.04 发行版的 LocalState 文件夹位于 C:\Users\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

请检查 WSL Docs GitHub 主题 #4103，其中跟踪了此问题以提供更新的信息。

无法将词语“wsl”识别为 cmdlet、函数、脚本文件或可运行程序的名称。

错误：适用于 Linux 的 Windows 子系统未安装发行版。

错误：此更新仅适用于装有适用于 Linux 的 Windows 子系统的计算机。

你仍使用旧版 Windows，不支持 WSL 2。 有关版本要求和要更新的链接，请参阅步骤 #2。

未启用 WSL。 需要返回到步骤 #1，并确保在计算机上启用了可选的 WSL 功能。

启用 WSL 后，需要重新启动才能使其生效，请重新启动计算机，然后重试。

错误： WSL 2 要求对其内核组件进行更新。 若需了解相关信息，请访问 https://aka.ms/wsl2kernel。

这可能是因为你的计算机尚未实现对 WSL 2 的向后移植。 要解决此问题，最简单的方法是转到 Windows 设置，然后打击“检查更新”，在你的系统上安装最新更新。 查看有关实现向后移植的完整说明。

如果你点击了“检查更新”，但仍未收到更新，可以手动安装 KB KB4566116。

当“显示语言”或“系统区域设置”未设为英语时，可能会发生此情况。

0x1bc 的实际错误为：

有关详细信息，请查看问题 5749

9p 协议文件服务器在 Linux 端提供服务，以允许 Windows 访问 Linux 文件系统。 如果在 Windows 上无法使用 \\wsl$ 访问 WSL，则可能是因为 9P 无法正确启动。

要检查这一点，可以使用 dmesg |grep 9p 来检查启动日志，这将显示任何错误。 成功的输出如下所示：

请参阅此 GitHub 主题获取有关此问题的进一步讨论。

如果你的显示语言不是英语，则可能会看到截断的错误文本。

要解决此问题，请访问 https://aka.ms/wsl2kernel，按照该文档页面上的指示手动安装内核。

用户可以直接从 Linux 运行 notepad.exe 等 Windows 可执行文件。 有时，你可能会点击“找不到命令”，如下所示：

如果 $PATH 中没有 win32 路径，互操作将找不到 .exe。 可以通过在 Linux 中运行 echo $PATH 来进行验证。 应会在输出中看到 win32 路径（例如，/mnt/c/Windows）。 如果看不到任何 Windows 路径，则很可能是 Linux shell 覆盖了 PATH。

以下是 Debian 上的 /etc/profile 导致此问题的一个示例：

Debian 上的正确方法是删除以上行。 还可在赋值过程中追加 $PATH（如下所示），但这可能导致 WSL 和 VSCode 的一些其他问题。

有关详细信息，请参阅问题 5296 和问题 5779。

请启用 Virtual Machine Platform Windows 功能，并确保在 BIOS 中启用了虚拟化。

请查看 Hyper-V 系统要求

如果你的计算机是 VM，请手动启用嵌套虚拟化。 使用 admin 启动 powershell，并运行：

请按照电脑制造商提供的虚拟化启用指南进行操作。 通常，这可能涉及使用系统 BIOS 来确保在 CPU 上启用了这些功能。 此过程的说明可能因计算机而异，有关示例，请参阅来自 Bleeping Computer 的本文。

启用 Virtual Machine Platform 可选组件后，请重启计算机。

确保在启动配置中启用了虚拟机监控程序启动。 可以通过运行（提升的 PowerShell）来对此进行验证：

如果看到 hypervisorlaunchtype Off，则会禁用虚拟机监控程序。 使其在提升的 PowerShell 中运行：

此外，如果安装了第三方虚拟机监控程序（例如 VMware 或 VirtualBox），请确保安装其最新版本（VMware 15.5.5+ 和 VirtualBox 6+这些版本可以支持 HyperV）或关闭它们。

详细了解在虚拟机中运行 Hyper-V 时如何配置嵌套虚拟化。

业务或企业环境可能已将 Windows Defender防火墙设置配置为阻止未经授权的网络流量。 如果本地规则合并设置为“否”，则 WSL 网络在默认情况下无效，并且管理员需要添加防火墙规则以允许它。

可以按照以下步骤确认本地规则合并的设置：

可在企业环境：为公司设置 WSL 中找到有关如何更改此项防火墙设置的说明。

如果在连接到 Windows 上的 VPN 后 bash 断开网络连接，请尝试从 bash 内部解决问题。 此解决方法允许通过 /etc/resolv.conf 手动替代 DNS 解析。

断开 VPN 连接后，必须将更改还原为 /etc/resolv.conf。 为此，请执行以下命令：

按照这些说明收集详细日志并在 GitHub 上提出问题。

适用于 Linux 的 Windows 子系统有两个组件需要更新。

若要更新适用于 Linux 的 Windows 子系统本身，请在 PowerShell 或 CMD 中使用命令 wsl --update。

若要更新特定的 Linux 发行版用户二进制文件，请在要更新的 Linux 发行版中使用命令：apt-get update | apt-get upgrade。

某些包使用我们尚未实现的功能。 例如，udev 尚不受支持，会导致多个 apt-get upgrade 错误。

若要解决与 udev 相关的问题，请执行以下步骤：

将以下内容写入 /usr/sbin/policy-rc.d 并保存更改。

将执行权限添加到 /usr/sbin/policy-rc.d：

运行以下命令：

此错误与我们不支持旧版控制台这一事实有关。 若要关闭旧版控制台：

在 Windows 更新期间可能禁用了“适用于 Linux 的 Windows 子系统”功能。 如果出现这种情况，则必须重新启用 Windows 功能。 在手动安装指南中可以找到有关启用“适用于 Linux 的 Windows 子系统”的说明。

WSL 安装会尝试自动更改 Ubuntu 区域设置，使之与 Windows 安装的区域设置相匹配。 如果你不希望出现此行为，可以在安装完成后，运行此命令来更改 Ubuntu 区域设置。 必须重新启动 bash.exe 才能使此项更改生效。

以下示例将区域设置更改为 en-US：

某些用户已报告特定的防火墙应用程序会阻止 WSL 中的 Internet 访问的问题。 报告的防火墙包括：

在某些情况下，关闭防火墙即可进行访问。 在某些情况下，只需让安装的防火墙在表面上阻止访问。

如果使用的是 Microsoft Defender 防火墙，取消选中“阻止所有传入连接，包括位于允许应用列表中的应用。”将允许访问。

对于 Windows 周年更新版本 1607，在 WSL 中运行 ping 命令需要拥有 Windows 中的管理员特权。 若要运行 ping，请以管理员身份运行 Windows 上的 Ubuntu Bash，或使用管理员特权从 CMD/PowerShell 提示符运行 bash.exe。

对于更高版本的 Windows（内部版本 14926 及更高版本），则不再需要管理员特权。

如果使用 bash 时发现 bash 挂起（或死锁）且不响应输入，请收集并报告内存转储来帮助我们诊断问题。 请注意，这些步骤会导致系统崩溃。 如果你不熟悉此过程，请不要这样做，或者，请在执行此操作之前保存你的工作。

收集内存转储

将内存转储类型更改为“完整内存转储”。 更改转储类型时，请记下当前类型。

遵循这些步骤使用键盘控制来配置崩溃。

再现挂起或死锁场景。

使用步骤 (2) 中的按键顺序来使系统崩溃。

系统将会崩溃并收集内存转储。

系统重新启动后，会将 memory.dmp 报告给 [email protected]。 转储文件的默认位置是 %SystemRoot%\memory.dmp 或 C:\Windows\memory.dmp（如果 C: 是系统驱动器）。 请注意，在电子邮件中，转储供 WSL 或 Windows 上的 Bash 团队参考。

将内存转储类型还原为原始设置。

若要查找电脑的体系结构和 Windows 内部版本号，请打开 “设置”>“系统”>“关于”

查看“OS 内部版本”和“系统类型”字段。

若要查找 Windows Server 内部版本号，请在 PowerShell 中运行以下命令：

可通过在提升的 PowerShell 窗口中运行以下命令来确认是否已启用“适用于 Linux 的 Windows 子系统”：

尝试连接 SSH 服务器失败并出现以下错误：“127.0.0.1 端口 22 已关闭连接”。

确保 OpenSSH 服务器正在运行：

并已按照此教程进行操作： https://ubuntu.com/server/docs/service-openssh

停止 sshd 服务，然后在调试模式下启动 sshd：

检查启动日志，确保已提供主机密钥，并且未看到如下所示的日志消息：

如果确实看到了此类消息，并且 /etc/ssh/ 下缺少主机密钥，则必须重新生成这些密钥，或者只是清除并安装 OpenSSH 服务器：

此错误与处于错误的安装状态相关。 请完成以下步骤来尝试解决此问题：

如果是从 PowerShell 运行了启用 WSL 功能的命令，请尝试改用 GUI，方法是打开“开始”菜单，搜索“启用或关闭 Windows 功能”，然后在列表中选择“适用于 Linux 的 Windows 子系统”，这将安装可选组件。

转到“设置”、“更新”，然后单击“检查更新”来更新 Windows 版本

如果这两个操作均失败，并且你需要访问 WSL，请考虑使用安装介质重新安装 Windows 并选择“保留所有内容”以确保保留你的应用和文件，从而就地升级。 可以在“重新安装 Windows 10”页面中找到有关如何执行此操作的说明。

如果看到此错误：

若要解决此问题，请将以下内容追加到 /etc/wsl.conf 文件：

请注意，添加此命令将包含元数据并修改有关从 WSL 中看到的 Windows 文件的文件权限。 有关详细信息，请参阅文件系统权限。

Microsoft Store 中提供的某些发行版尚不具备直接运行 Windows 命令的完全兼容性。 如果在运行 powershell.exe /c start . 或任何其他 Windows 命令时收到错误 -bash: powershell.exe: command not found，可按照以下步骤予以解决：

我们注意到用户在安装 WSL 2 后无法启动的问题。 我们对该问题进行了全面诊断，而用户报告称更改缓冲区大小或安装适当的驱动程序可帮助解决此问题。 请查看此 GitHub 问题了解有关此问题的最新更新。

Internet 连接共享 (ICS) 是 WSL 2 的必需组件。 主机网络服务 (HNS) 使用 ICS 服务来创建基础虚拟网络，WSL 2 依赖该网络来进行 NAT、DNS、DHCP 和主机连接共享。

禁用 ICS 服务 (SharedAccess) 或通过组策略禁用 ICS 会阻止创建 WSL HNS 网络。 这将导致在创建新的 WSL 版本 2 映像时失败，并在尝试将版本 1 映像转换为版本 2 时出现以下错误。

需要 WSL 2 的系统应将 ICS 服务 (SharedAccess) 保留在“手动(触发启动)”这一默认启动状态，并且应覆盖或删除禁用 ICS 的所有策略。 虽然禁用 ICS 服务会破坏 WSL 2，我们不建议禁用 ICS，但可以使用这些说明禁用 ICS 部分。

如果运行的是旧版 Windows 和 WSL，例如 Windows 10 创意者更新（2017 年 10 月的内部版本 16299）或周年更新（2016 年 8 月的内部版本 14393），则有几处差异需要注意。 建议更新到最新的 Windows 版本，但如果无法执行此操作，请了解下面概述的一些差异。

互操作性命令差异：

如果最初在创意者更新（2017 年 10 月的内部版本 16299）前的某个 Windows 10 版本上安装了 WSL，我们建议你将任何必需的文件、数据等从安装的旧 Linux 发行版迁移到通过 Microsoft Store 安装的新发行版。 若要从计算机中删除旧发行版，请通过命令行或 PowerShell 实例运行以下命令：wsl --unregister Legacy。 还可以选择手动删除旧发行版，方法是使用 Windows 文件资源管理器或 PowerShell 删除 %localappdata%\lxss\ 文件夹（及其所有子内容）：rm -Recurse $env:localappdata/lxss/。