Windows 10下Docker安装失败求助：WSL集成超时问题

错误信息 #

Docker.Core.HttpBadResponseException:
{"message":"1 error occurred:\n\t* starting WSL integration service: synchronising agents: starting added distros: 1 error occurred:\n\t* waiting for WSL integration for Ubuntu: timed out while polling for WSL distro integration to become ready in "Ubuntu"\n\n\n\n"}

at Docker.Core.GoBackend.GoBackendClient.d__19.MoveNext() in C:\workspaces\4.16.x\src\github.com\docker\pinata\win\src\Docker.Core\GoBackend\GoBackendClient.cs:line 226
--- End of stack trace from previous location where exception was thrown ---
...（省略后续堆栈信息）

可行解决方案 #

1. 重置WSL Ubuntu发行版 #

• 打开管理员PowerShell，执行命令查看已安装的WSL发行版：

  wsl --list --verbose
  

• 找到Ubuntu发行版，执行注销并重新安装命令：

  wsl --unregister Ubuntu
  wsl --install Ubuntu
  

• 启动Ubuntu完成用户名和密码设置后，重新运行Docker安装程序。

2. 更新WSL到最新版本 #

• 在管理员PowerShell中执行：

  wsl --update
  

• 更新完成后重启电脑，再尝试安装Docker。

3. 手动启用WSL相关Windows功能 #

• 打开控制面板 → 程序 → 启用或关闭Windows功能，确保以下功能已勾选：
  • 适用于Linux的Windows子系统
  • 虚拟机平台
• 勾选后点击确定，重启电脑。

4. 调整Docker的WSL集成设置（安装后仍报错时） #

• 打开Docker设置 → Resources → WSL Integration
• 取消勾选Ubuntu，点击Apply & Restart；等待Docker重启后，重新勾选Ubuntu并再次重启。

5. 强制Docker使用WSL 2后端 #

• 卸载当前Docker，重新运行安装程序时，在配置步骤中勾选Use WSL 2 instead of Hyper-V（系统支持前提下），完成安装后重启电脑。

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