2026年11月

遇到的问题:Docker Desktop 打开时,在终端输入 wsl,wsl超时,无法响应;退出 Docker Desktop 后,WSL 又能正常进入。

解决:关闭 Docker Desktop 的 Resource Saver。

这里记录一下排查过程。

我电脑上的主要环境如下:

项目 版本或状态
Docker Desktop 4.37.1
WSL 2.5.9
Linux 内核 6.6.87.2
默认发行版 Ubuntu,使用 WSL 2
Docker 后端发行版 docker-desktop,使用 WSL 2

主要的发现是,wsl的超时无法响应的问题会在 Docker Desktop 关闭,Docker Engine未运行的时候消失。 也就是说关掉docker,wsl就可以用了。

这个发现让我把排查重点放在 Docker 与 WSL 的交互上。

排查时先执行了:

wsl -l -v

命令能够正常返回:

  NAME              STATE           VERSION
* Ubuntu            Running         2
  docker-desktop    Running         2

但再执行一个非常简单的命令:

wsl -d Ubuntu --exec /bin/echo WSL_OK

这个命令就超时无法响应了。

wsl -l -v 的输出是发行版状态和 WSL 版本; 它能够列出 Ubuntu 说明wsl可以正确识别安装的操作系统。

继续检查 Docker 日志,发现了几条与问题有关的记录。下面只保留关键字段:

"useResourceSaver":true

IsPaused:true
PauseText:Docker Desktop is paused
Idle:paused

也就是说,Docker 启用了 Resource Saver,并且日志里出现过引擎暂停状态。 看这个日志,感觉wsl启动响应超时可能是和 Docker 的 Resource Saver 有关。

Docker 官方文档说明,在 Windows 的 WSL 后端下,Resource Saver 会暂停 docker-desktop 发行版中的 Docker Engine。Ubuntu 和 docker-desktop 虽然是两个发行版,但它们共享底层的 WSL 2 Linux 虚拟机。两者的关系可以简化成下面这样:(docs.docker.com)

flowchart TB;
W["Windows / WSL 服务"] --> V["共享的 WSL 2 Linux 虚拟机"];
V --> U["Ubuntu"];
V --> D["docker-desktop"];
R["Docker Desktop:Resource Saver"] -->|"暂停引擎"| D;

这张图解释了它们为什么存在相互影响的可能。

在 Docker 的问题跟踪仓库里,Issue #14827 记录了非常接近的表现:暂停 Docker Desktop 后,已有 WSL 终端冻结,新终端可能报 Wsl/Service/E_UNEXPECTED;恢复 Docker 后,终端重新响应。Issue #14656 则讨论了 cgroup v2 环境下,暂停和 Resource Saver 与 WSL 挂起之间的关系。(github.com)

日志中的暂停状态、Ubuntu 命令无法执行,以及退出 Docker 后恢复的现象,和这些issue表现差不多。所以确认了大概就是 Resource Saver 的问题。

后面在 Docker Desktop 的设置, Settings → Resources 中关闭 Resource Saver。

重新执行上面的命令,返回了 Wsl/Service/E_UNEXPECTED。 应该是需要重新启动相关环境。

恢复时,先从系统托盘退出 Docker Desktop,然后在 Windows PowerShell 中执行:

wsl --shutdown
wsl -d Ubuntu

wsl --shutdown 会停止所有正在运行的 WSL 发行版和底层 WSL 2 虚拟机。

Ubuntu 能正常进入后,再启动 Docker Desktop,并保持 Resource Saver 关闭。

然后在 Docker 启动的情况下执行:

wsl

可以正常进入 wsl 子系统。

这次处理后,WSL 恢复正常。更准确地说,关闭 Resource Saver 是针对可疑触发条件的规避措施。