Docker Desktop 开着,WSL 就超时?排查记录
遇到的问题: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 是针对可疑触发条件的规避措施。