已解决：Docker Desktop 意外的 WSL 错误

Docker Desktop 允许用户开发、管理和共享 Docker 化应用程序，但少数应用程序在启动应用程序时收到意外的 WSL 错误。

它可能在 Windows 和 Mac 上遇到，尽管我们在前者上看到了更多实例。最近遇到错误消息“Docker Desktop – 意外的 WSL 错误”的大多数用户都在运行 Windows 11。

Docker Desktop 中的 WSL2 错误是什么？

Docker Desktop 的 WSL2 错误表明权限配置错误或缺少关键组件，尤其是虚拟机平台（Windows 中的一项可选功能）。

此外，如果未安装 WSL 本身，则不会执行任何 WSL 命令。许多人认为网络问题也是根本原因。

如何修复 Docker Desktop 上的意外 WSL 错误？

在我们深入研究稍微复杂的解决方案之前，请尝试以下快速解决方案：

• 验证您的设备是否满足Docker Desktop 的最低要求。
• 重新启动电脑。如果每次都必须重新启动才能运行 Docker Desktop，请尝试其他解决方案。
• 检查可用更新并从官方网站安装最新版本的 Docker Desktop 。另外，更新操作系统。它帮助了许多遇到意外错误发生的人。重新启动 Docker Desktop 消息。
• 确保 Docker Desktop以管理权限运行，以消除任何访问权限问题。当Docker Desktop 需要很长时间才能启动时，这也很有帮助。
• 禁用 PC 上的任何第三方防病毒软件。

如果都不起作用，请前往下面列出的修复程序。

1.安装WSL

1. 按Windows +S 打开搜索，在搜索栏中键入命令提示符，然后单击以管理员身份运行。
2. 在 UAC 提示中单击“是” 。
3. 现在，粘贴以下命令并点击Enter 安装 WSL： wsl --install
4. 完成后，重新启动电脑并检查是否有改进。

如果未安装适用于 Linux 的 Windows 子系统，您将收到 Docker Desktop – 意外的 WSL 错误。完成此操作后，还要在设备上启用 Hyper-V 。这对于 Docker Desktop 的运行至关重要。

2.更新WSL

1. 按Windows+R打开“运行”，输入cmd，然后点击Ctrl+ Shift+ Enter。
2. 在出现的提示中单击“是” 。
3. 粘贴以下命令并点击Enter 以更新 WSL： wsl --update
4. 如果安装了任何更新，请重新启动电脑。

3.修改settings.json文件

1. 按Windows +E 打开文件资源管理器，将以下路径粘贴到地址栏中，然后点击Enter： %Appdata%\Docker
2. 双击settings.json文件。
3. 现在，确保它显示以下内容："integratedWslDistros": [ ]"enableIntegrationWithDefaultWslDistro": false
4. 如果需要，进行必要的编辑并保存更改。
5. 完成后，重新启动项目，它不应该再抛出 Docker Desktop failed to start WSL2 错误。

4. 更改命令提示符设置

1. 按Windows+S打开搜索，键入命令提示符，右键单击相关结果，然后选择以管理员身份运行。
2. 在出现的 UAC 提示中单击“是” 。
3. 现在，右键单击顶部栏，然后从上下文菜单中选择“属性” 。
4. 转到“选项”选项卡，勾选“使用旧版控制台”复选框，然后单击“确定”保存更改。

5.重置winsock

1. 按Windows+R打开“运行”，键入cmd，按住Ctrl+Shift键，然后单击“确定”。
2. 在提示中单击“是” 。
3. 现在，单独粘贴以下两个命令并Enter 在每个命令后单击以重置损坏或配置错误的网络设置： netsh int ip reset netsh winsock reset
4. 重新启动 PC 并检查 Docker Desktop 启动失败错误是否消失。

6. 在 BIOS 中启用硬件虚拟化

1. 关闭计算机，然后打开电源，显示屏出现后，按住 、F2、 F10或 键以访问 BIOS（具体取决于系统制造商）F12。 EscDel
2. 现在，使用箭头键转到“高级”或“系统配置”选项卡，然后选择“虚拟化技术”。
3. 最后，选择Enable，然后保存更改并退出 BIOS。

在 PC 上启用虚拟化支持对于 Docker Desktop 的正常工作至关重要。如果没有这个，您可能会收到 Docker Desktop – Unexpected WSL 错误。

7. 重新安装 WSL

1. 按Windows +I 打开“设置”，从导航窗格转到“应用程序”，然后单击右侧的“已安装的应用程序” 。
2. 现在，找到Windows Subsystem for Linux，单击旁边的省略号，然后选择卸载。
3. 再次单击确认提示中的“卸载” 。
4. 同样，删除已安装应用程序下的以下条目（如果存在）：
   • Linux
   • 乌班图
5. 现在，返回“应用程序”选项卡，然后选择“可选功能”。
6. 单击底部的“更多 Windows 功能” 。
7. 取消选中虚拟机平台和适用于 Linux 的 Windows 子系统的复选框，然后单击“确定”保存更改。
8. 重新启动计算机以使更改生效。
9. 完成后，重新安装 WSL（适用于 Linux 的 Windows 子系统）。

如果其他方法都不起作用，您可以随时重新安装 WSL 并摆脱 Docker Desktop – Unexpected WSL 错误。首先卸载 WSL，然后重新下载所有组件。

Windows WSL 中 Docker Desktop 的替代方案是什么？

Docker Desktop 有多种替代方案，考虑到该项目许可条款的最新变化，许多用户已经转向这些方案。以下是流行的选项：

• Rancher 桌面
• 迷你库贝
• 波德曼

切换到其他软件时，请确保验证与您的操作系统的兼容性、功能集、性能、易用性、支持团队的效率以及发布更新的频率。

到目前为止，您一定已经摆脱了 Docker Desktop – Unexpected WSL 错误。如果情况并非如此，要么等待更新，要么改用可靠的替代方案。你知道所有的选择！

此外，还有其他影响用户的安装错误。例如，许多人在安装 Docker Desktop 时遇到了Hyper-V 和容器 Windows 功能必须启用错误，但这很容易修复！

如有任何疑问或分享对您有用的方法，请在下面发表评论。