Windows 11下WSL初始化失败致Docker无法启动求助

1. 强制启用虚拟化相关功能并重启 #

打开管理员PowerShell，依次执行以下命令：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart

执行完成后重启电脑，确保功能完全生效。

2. 重置WSL所有注册分发版 #

同样在管理员PowerShell中执行：

wsl --shutdown
wsl --unregister docker-desktop
wsl --unregister docker-desktop-data
# 如果之前安装了Ubuntu，也一并注销
wsl --unregister Ubuntu

这一步会清除所有WSL分发版的损坏注册信息。

3. 确认WSL默认版本为2并更新内核 #

执行命令设置默认版本：

wsl --set-default-version 2

如果提示需要更新WSL2内核，手动下载并安装微软官方的WSL2 Linux内核更新包，完成后重新执行上述命令。

4. 重新安装Docker并配置WSL集成 #

• 完全卸载当前Docker，确保删除所有残留文件（包括%programfiles%\Docker目录）
• 重新下载Docker Desktop安装包，安装时选择使用WSL2作为后端
• 安装完成后打开Docker设置，进入Resources > WSL Integration，启用对应的WSL分发版（如Ubuntu）

5. 关闭Windows快速启动功能 #

快速启动会导致WSL虚拟网络异常，操作步骤：

• 打开控制面板 → 电源选项 → 选择电源按钮的功能
• 点击“更改当前不可用的设置”，取消勾选“启用快速启动”，保存后重启电脑

6. 检查BIOS虚拟化设置 #

重启电脑进入BIOS界面（不同品牌按键不同，通常是F2、Del或Esc），找到**虚拟化技术（VT-x/AMD-V）**选项，确保其处于启用状态，保存设置后重启系统。

错误原因说明 #

• winapi error #2147746562：通常是WSL分发版的注册信息损坏，或虚拟化相关Windows功能未正确启用
• \\wsl$\docker-desktop-data\isocache\: The network name cannot be found：WSL虚拟网络服务未正常运行，或快速启动导致的网络残留问题

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