PowerShell中Docker命令失败但VS开发者命令提示符正常的原因与解决

在PowerShell中执行docker命令时返回错误：

There is no distribution with the supplied name.
Error code: Wsl/Service/WSL_E_DISTRO_NOT_FOUND

但在Visual Studio开发者命令提示符中执行相同命令可正常显示使用信息；另一台配置相似的电脑上，PowerShell和命令提示符均能正常运行该命令。求问该行为差异的原因及解决方法。

两台电脑均安装Docker Desktop（WSL2模式，运行无报错），共同配置：

• Docker Desktop v4.37.1 (178610)
• Docker Engine v27.4.0

出现问题的电脑：

• Windows 10 v22H2 (19045.5247)
• PowerShell v5.1.19041.5247

运行正常的电脑：

• Windows 10 v22H2 (19045.5131)
• PowerShell v5.1.19041.5129

两台电脑均运行以下服务：

• Hyper-V Host Compute Service
• Hyper-V Virtual Machine Management
• WSL Service

两台电脑在PowerShell中执行Get-Command docker | ForEach-Object Path的结果一致：

• C:\Program Files\Docker\Docker\resources\bin\docker.exe
• C:\Program Files\Docker\Docker\resources\bin\docker

两台电脑执行wsl -l -v的结果一致：

• 重新安装Docker Desktop
• 执行社区教程中的修复步骤
• 运行com.docker.diagnose.exe check，最初报告多项失败，手动启动Docker Desktop Service后失败项解决，但另一台电脑停止该服务仍可正常执行docker命令

可能原因 #

1. PowerShell的PATH优先级异常：虽然Get-Command显示了docker路径，但PowerShell可能优先调用了无后缀的docker（WSL桥接脚本），而非Docker Desktop的docker.exe；开发者命令提示符的PATH顺序不同，优先执行了可执行文件。
2. WSL默认分发版配置缓存异常：尽管wsl -l -v显示docker-desktop为默认分发版，但PowerShell环境中的WSL配置存在缓存错误，导致调用docker时无法识别分发版。
3. PowerShell环境配置差异：两台电脑的PowerShell配置文件（$PROFILE）或环境变量存在细微差异，影响了docker命令的执行逻辑。

解决方案 #

1. 强制指定Docker Desktop的可执行文件 #

在PowerShell中直接调用完整路径测试：

& "C:\Program Files\Docker\Docker\resources\bin\docker.exe" --version

若正常运行，说明是PATH优先级问题。可调整PowerShell的PATH顺序，将C:\Program Files\Docker\Docker\resources\bin移至WSL相关路径之前。

2. 重置WSL默认分发版 #

执行以下命令重新设置默认分发版：

wsl --set-default docker-desktop

重启PowerShell后再次测试docker命令。

3. 检查PowerShell环境配置 #

• 查看PowerShell配置文件，确认是否存在修改PATH或WSL的自定义配置：

  Get-Content $PROFILE -ErrorAction SilentlyContinue
  

• 对比两台电脑的环境变量，重点检查PATH、WSL_DISTRO_NAME：

  Get-ChildItem Env:PATH
  Get-ChildItem Env:WSL_DISTRO_NAME
  

发现异常变量后删除或修正，重启PowerShell。

4. 重置Docker Desktop的WSL集成 #

打开Docker Desktop设置，进入Resources > WSL Integration，先取消勾选docker-desktop并应用，再重新勾选应用，最后重启Docker Desktop和PowerShell。

5. 修复WSL组件 #

执行WSL修复命令：

wsl --shutdown
wsl --repair

完成后重启电脑，再次测试docker命令。

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