WSL2 Ubuntu提示docker命令不存在 已开WSL集成仍报错求助

问题背景 #

• 运行环境：Windows系统下基于Ubuntu的WSL 2环境，已安装Docker Desktop并保持后台运行，已在Docker Desktop设置中开启对应Ubuntu发行版的WSL集成
• 正常场景：PowerShell、CMD环境可正常执行docker --version等所有Docker命令
• 故障场景：Ubuntu WSL终端执行Docker相关基础命令时返回如下报错：

The command 'docker' could not be found in this WSL 2 distro.
We recommend to activate the WSL integration in Docker Desktop settings.
For details about using Docker Desktop with WSL 2, visit:
https://docs.docker.com/go/wsl2/

• 已完成排查：对照官方指引确认WSL集成开关处于开启状态（配置参考：），故障仍复现。

修复操作（按优先级顺序尝试，每步完成后可直接测试docker --version验证是否恢复） #

1. 重启WSL子系统（90%的同类故障可通过这步解决）
   WSL集成配置修改后不会在运行中的WSL实例里热加载，必须全量关闭WSL后重开才能生效：
   • 打开任意PowerShell窗口，执行命令：

   wsl --shutdown
   

   • 等待10秒左右重新打开Ubuntu终端，测试Docker命令。
2. 补全命令软链与用户组配置
   如果重启WSL后仍无法识别命令，大概率是集成的二进制文件路径没有被正确链接到系统PATH目录：
   • 打开Ubuntu终端，依次执行以下命令：

   # 确认docker用户组存在，不存在则创建
   sudo groupadd -f docker
   # 将当前用户加入docker用户组
   sudo usermod -aG docker $USER
   # 为Docker Desktop内置的docker、docker-compose二进制创建全局软链
   sudo ln -sf /mnt/wsl/docker-desktop/cli-tools/usr/bin/docker /usr/local/bin/docker
   sudo ln -sf /mnt/wsl/docker-desktop/cli-tools/usr/bin/docker-compose /usr/local/bin/docker-compose
   

   • 执行完成后关闭当前Ubuntu窗口，重新打开测试命令。
3. 重置Docker Desktop WSL集成状态
   • 右键系统托盘的Docker Desktop图标，选择「Quit Docker Desktop」完全退出程序
   • 右键Docker Desktop快捷方式，选择「以管理员身份运行」启动程序
   • 进入设置页找到WSL集成配置项，先关闭对应Ubuntu发行版的集成开关，点击「应用」保存；再重新打开该开关，再次点击「应用」保存
   • 回到PowerShell执行wsl --shutdown重启WSL，打开Ubuntu测试。
4. 清理冲突的原生Docker安装包
   如果之前在Ubuntu里通过apt手动安装过docker.io、docker-engine等Docker包，会和Docker Desktop的集成命令产生冲突，执行以下命令卸载冲突包：

   sudo apt remove -y docker docker-engine docker.io containerd runc
   

   卸载完成后重启WSL即可。

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