Windows Docker Desktop 启动报错 Hyper-V 未启用或版本不兼容如何解决

约 5 分钟读完 224 阅
文章导读
遇到这个报错通常是因为 Windows 的虚拟化功能没有打开，或者 Docker Desktop 没有正确切换到 WSL 2 后端。最直接的解决方向是先在系统中启用必要的虚拟化组件，再在 Docker 设置中调整后端模式。
📋 目录
  1. A 典型报错信息
  2. B 命令速用版
  3. C 为什么会这样
  4. D 分步处理
  5. E 怎么验证是否生效
  6. F 常见坑
  7. G 参考来源
A A

遇到这个报错通常是因为 Windows 的虚拟化功能没有打开，或者 Docker Desktop 没有正确切换到 WSL 2 后端。最直接的解决方向是先在系统中启用必要的虚拟化组件，再在 Docker 设置中调整后端模式。

先说结论：核心是确保底层虚拟化可用，并让 Docker 识别到它，优先推荐使用 WSL 2 后端而非传统 Hyper-V 后端。

  • 先确认：检查 BIOS 中虚拟化技术（VT-x/AMD-V）是否开启
  • 先处理：通过 PowerShell 启用 Windows 虚拟化平台功能
  • 再验证：重启后查看 Docker 状态及 WSL 版本

典型报错信息

在启动 Docker Desktop 时，您可能会看到以下类似提示，确认匹配后再进行后续操作：

  • Error: Hyper-V is not enabled
  • WSL 2 installation is incomplete
  • The virtual machine could not be started because the Hypervisor is not running

命令速用版

以管理员身份打开 PowerShell，依次执行以下命令启用必要功能：

Windows Docker Desktop 启动报错 Hyper-V 未启用或版本不兼容如何解决
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl `--set-default-version` 2

执行完后需要重启电脑。

为什么会这样

Docker Desktop 在 Windows 上运行容器需要依赖一个 Linux 内核环境。早期版本强依赖 Hyper-V 虚拟机，而新版本默认使用 WSL 2（Windows Subsystem for Linux）后端。如果系统底层的虚拟化支持未开启，或者 Windows 功能中缺少相关组件，Docker 就无法创建运行环境，从而报出 Hyper-V 未启用或兼容性问题。

Windows Docker Desktop 启动报错 Hyper-V 未启用或版本不兼容如何解决

分步处理

1. 检查 BIOS 虚拟化设置
重启电脑进入 BIOS/UEFI 设置，找到 Intel VT-x 或 AMD-V 选项，确保状态为 Enabled。如果这里没开，系统层面的所有虚拟化功能都无法使用。

2. 启用 Windows 功能
除了使用上面的命令，也可以手动打开“控制面板” > “程序” > “启用或关闭 Windows 功能”，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”。如果是专业版及以上系统，建议同时勾选"Hyper-V"。

3. 更新 WSL 内核
访问 Microsoft 官方文档下载最新的 WSL 2 Linux 内核更新包并安装，确保内核版本支持 Docker 运行。

Windows Docker Desktop 启动报错 Hyper-V 未启用或版本不兼容如何解决

4. 调整 Docker 设置
打开 Docker Desktop 设置，进入 Settings > General，确保"Use WSL 2 based engine"被勾选。如果之前使用的是 Hyper-V 后端，切换后需要重启 Docker。

怎么验证是否生效

在 PowerShell 中输入 wsl -l -v，查看输出的 VERSION 列是否为 2。接着在终端运行 docker run hello-world，如果能正常拉取镜像并打印欢迎信息，说明环境已就绪。

常见坑

  • Windows 版本过低：WSL 2 需要 Windows 10 版本 2004 及以上（内部版本 19041 及以上）或 Windows 11，旧版本可能不支持。
  • 第三方软件冲突：某些杀毒软件或虚拟机软件（如旧版 VirtualBox 或 VMware Workstation 15.5.5 以下版本）可能会独占虚拟化资源，导致 Docker 无法启动。如需共存，请升级 VMware 至支持 Hyper-V 共存的版本。
  • 命令未管理员运行：启用 Windows 功能的命令必须以管理员身份运行，否则会提示拒绝访问。

参考来源

  • Microsoft Learn - 安装 WSL：https://learn.microsoft.com/zh-cn/windows/wsl/install
  • Docker Docs - Install Docker Desktop on Windows：https://docs.docker.com/desktop/install/windows-install/
  • Microsoft Learn - 启用 Hyper-V：https://learn.microsoft.com/zh-cn/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v