Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法,只需打开 PowerShell(以管理员身份),输入 wsl --update 即可

用 Apifox,节省研发团队的每一分钟

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

在 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 架构:

  1. Win + R,输入 msinfo32 并回车;
  2. 查找【系统类型】,显示为 x64-based PC 则为兼容架构;
  3. 或打开 CMD,输入:
echo %PROCESSOR_ARCHITECTURE%

4. 显示 AMD64 即为 x64 架构。只要是 x64(也称 AMD64)架构的电脑,就支持 Docker Desktop,问题不是硬件兼容性引起的。

 

报错原因分析

Docker Desktop 依赖 WSL 2 来运行容器。如果 WSL 组件未更新成功,Docker 就无法正常启动。这类报错通常出现在:

  • WSL 核心组件版本过旧;
  • Windows 功能项未正确启用;
  • 网络或权限限制了自动更新;
  • 系统中 WSL 发行版异常或已损坏。

 

解决方案

方法一:手动更新 WSL 组件

1. 打开 PowerShell(以管理员身份)

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

2. 输入:

wsl --update
Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

若仍失败,可以尝试强制从微软服务器下载更新:

wsl --update --web-download

更新完毕后,重启 Docker Desktop 即可。

 

如果上面的子系统更新成功,重启 Docker Desktop 时还是显示 “WSL update failed”,说明系统内部可能存在异常配置。可以尝试一下软重启 WSL,在 PowerShell(以管理员身份)输入下面的命令即可:

wsl --shutdown

   

如果软重启不行,那只能来点硬的了。

  • 按下 Win + R,输入下面的命令,点击确定:
optionalfeatures.exe
Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法
  • 取消勾选「适用于 Linux 的 Windows 子系统」,点击“确定”。
Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法
  • 重启电脑
  • 重启后打开 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
Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

     

启动 Docker Desktop

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

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法


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

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

 

总结

WSL 是 Windows 上运行 Linux 的桥梁,也是 Docker Desktop 的运行基础。WSL 更新失败并非不可恢复的错误,只需手动操作几步即可解决。

 

开发必备:API 全流程管理神器 Apifox  

介绍完上文的错误处理教程,我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档API 调试API 设计API 测试API Mock自动化测试等功能于一体的 API 管理工具,Apifox 可以说是开发者提升效率的必备工具之一。

 
如果你正在开发项目需要进行接口调试,不妨试试 Apifox。注册过程非常简单,你可以直接在这里注册使用

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法



注册成功后可以先看看官方提供的示例项目,这些案例都是经过精心设计的,能帮助你快速了解 Apifox 的主要功能。

 
使用 Apifox 的一大优势是它完全兼容 PostmanSwagger 数据格式,如果你之前使用过这些工具,数据导入会非常方便。而且它的界面设计非常友好,即使是第一次接触的新手也能很快上手,快去试试吧!

Windows 安装 Docker Desktop 提示 “WSL update failed” 的解决方法

了解更多: