在 Windows 系统上安装或启动 Docker Desktop 时,如果遇到如下报错:
Docker Desktop - WSL update failed
An error occurred while updating WSL.
You can manually update using wsl --update.
...
exit status 1
这并不是你的电脑架构不支持,而是 WSL(Windows 子系统 Linux)组件未正确更新或配置异常。这篇文章将带你一步步解决问题。
前提条件:你的电脑是否支持 Docker Desktop?
首先确认你的电脑是否为 x64 架构:
- 按
Win + R
,输入msinfo32
并回车; - 查找【系统类型】,显示为
x64-based PC
则为兼容架构; - 或打开 CMD,输入:
echo %PROCESSOR_ARCHITECTURE%
4. 显示 AMD64
即为 x64 架构。只要是 x64(也称 AMD64)架构的电脑,就支持 Docker Desktop,问题不是硬件兼容性引起的。
报错原因分析
Docker Desktop 依赖 WSL 2 来运行容器。如果 WSL 组件未更新成功,Docker 就无法正常启动。这类报错通常出现在:
- WSL 核心组件版本过旧;
- Windows 功能项未正确启用;
- 网络或权限限制了自动更新;
- 系统中 WSL 发行版异常或已损坏。
解决方案
方法一:手动更新 WSL 组件
1. 打开 PowerShell(以管理员身份);

2. 输入:
wsl --update

若仍失败,可以尝试强制从微软服务器下载更新:
wsl --update --web-download
更新完毕后,重启 Docker Desktop 即可。
如果上面的子系统更新成功,重启 Docker Desktop 时还是显示 “WSL update failed”,说明系统内部可能存在异常配置。可以尝试一下软重启 WSL,在 PowerShell(以管理员身份)输入下面的命令即可:
wsl --shutdown
如果软重启不行,那只能来点硬的了。
- 按下
Win + R
,输入下面的命令,点击确定:
optionalfeatures.exe

- 取消勾选「适用于 Linux 的 Windows 子系统」,点击“确定”。

- 重启电脑
- 重启后打开 PowerShell(以管理员身份),执行:
wsl --update
- 然后再次按下
Win + R
打开optionalfeatures.exe
,重新勾选「适用于 Linux 的 Windows 子系统」 - 最后打开 Docker Desktop(如果还报错可以看一下其它方案或者其它博主的文章)
方法二:启用必要的 Windows 功能
确保启用了 WSL 和虚拟机平台:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
然后重启系统。
方法三:手动安装最新版 WSL 内核
部分用户可能缺少新版 Linux 内核支持组件。你可以通过官方渠道手动下载安装:🔗 下载地址(微软官网)安装完成后再次运行:
wsl --update
验证结果
完成上述步骤后,重新启动 Docker Desktop,WSL 更新失败的问题应该已经解决。如果仍有问题,可以在 CMD 中运行以下命令,确认 WSL 是否可用:
wsl --status

启动 Docker Desktop
如果 WSL 组件更新成功,那么可以点击桌面上的 Docker 图标重新打开 Docker Desktop 试试。

启动 Docker Desktop 后,首次打开会要求你登录 Docker 账号,按提示登录即可。登录后,可以在 Docker Desktop 的“Docker Hub”页面中搜索需要的镜像,并直接安装。

总结
WSL 是 Windows 上运行 Linux 的桥梁,也是 Docker Desktop 的运行基础。WSL 更新失败并非不可恢复的错误,只需手动操作几步即可解决。
开发必备:API 全流程管理神器 Apifox
介绍完上文的错误处理教程,我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、API 调试、API 设计、API 测试、API Mock、自动化测试等功能于一体的 API 管理工具,Apifox 可以说是开发者提升效率的必备工具之一。
如果你正在开发项目需要进行接口调试,不妨试试 Apifox。注册过程非常简单,你可以直接在这里注册使用。

注册成功后可以先看看官方提供的示例项目,这些案例都是经过精心设计的,能帮助你快速了解 Apifox 的主要功能。
使用 Apifox 的一大优势是它完全兼容 Postman 和 Swagger 数据格式,如果你之前使用过这些工具,数据导入会非常方便。而且它的界面设计非常友好,即使是第一次接触的新手也能很快上手,快去试试吧!

了解更多: