Windows11启动Docker Desktop遇WSL升级失败（错误码1603）求助

问题详情 #

启动Docker Desktop时触发如下WSL相关错误：

Docker Desktop - Unexpected WSL error

执行WSL命令时遇到意外错误。常见原因包括权限问题，比如电脑唤醒后或未连接域/活动目录时出现的情况。

请尝试关闭WSL（wsl --shutdown）和/或重启电脑。若无效，可能需要完全重新安装WSL。最后可尝试安装/重新安装Docker Desktop。若问题仍存在，请收集诊断信息并提交问题。

在CMD中执行wsl --shutdown命令时，返回错误：

WSL is finishing an upgrade...
Update failed (exit code: 1603).
Error code: Wsl/CallMsi/E_ABORT

已尝试的操作均无效：

• 切换管理员权限执行命令
• 重启电脑
• 重新安装Docker Desktop
• 完全重装WSL（含所有虚拟机服务）

系统版本：Windows 11 Home Single Language 22621.2715

需求：正常启动Docker Desktop

可行解决步骤 #

1. 终止WSL进程并清理升级残留 #

• 打开任务管理器，强制结束所有包含wsl、Ubuntu（或你使用的WSL发行版名称）、docker的进程
• 以管理员权限打开文件资源管理器，导航到C:\Windows\System32\lxss，删除其中的upgrade文件夹

2. 修复WSL组件并手动更新 #

• 以管理员身份打开PowerShell，执行系统组件修复命令：

  dism.exe /online /cleanup-image /restorehealth
  

• 执行手动更新WSL的命令，绕开自动升级的问题：

  wsl --update --web-download
  

3. 重置WSL发行版 #

• 管理员PowerShell中执行，注销当前WSL发行版（替换<发行版名称>为实际名称，如Ubuntu）：

  wsl --unregister <发行版名称>
  

• 重新安装默认WSL发行版：

  wsl --install
  

4. 彻底重置Docker Desktop #

• 卸载Docker Desktop，手动清理残留文件：
  • 删除C:\Program Files\Docker
  • 删除%APPDATA%\Docker
  • 删除%LOCALAPPDATA%\Docker
• 重新安装Docker Desktop，安装时选择WSL 2后端，完成后在设置中启用对应WSL发行版的集成

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