wsl --list --verbose 卡住表明 WSL 服务层失联,根本原因是 Windows 的 WSL 服务卡在 START_PENDING 状态,常见诱因包括 ext4.vhdx 文件损坏、WSL 内核更新失败、网络工具劫持 Winsock 或安全软件拦截 wsl.exe/vmwp.exe 进程。

为什么 wsl --list --verbose 会卡住
这是最直接的信号:Docker Desktop 显示“WSL integration disconnected”,同时你在终端里执行 wsl --list --verbose 也无响应或超时,说明 WSL 服务层本身已失联。根本原因不是 Docker Desktop 坏了,而是 Windows 的 WSL 服务卡在 START_PENDING 状态,无法完成初始化。
常见诱因包括:
• ext4.vhdx 虚拟磁盘文件损坏(尤其在非正常关机、磁盘空间满、杀毒软件扫描时)
• WSL 内核更新失败后残留旧内核模块,与新版本不兼容
• 第三方网络工具(如 Clash、Surge)劫持了 Winsock,导致 WSL 启动时网络栈初始化失败
• 安全软件(如 McAfee、360)静默拦截 wsl.exe 或 vmwp.exe 进程
实操建议:
• 先以管理员身份运行 netsh winsock reset,再执行 wsl --shutdown
• 检查 C:Users{user}AppDataLocalPackages 下各发行版目录,看是否存在异常增大的 ext4.vhdx(>10GB 且长时间未变)
• 临时禁用所有安全软件和代理客户端,再试 wsl -l -v
docker version 能输出但 docker info 报错 connection refused
这说明 Docker CLI 可以读取本地配置,但无法连接到 WSL 中的 dockerd 守护进程。典型错误是:error during connect: Get "http://docker.socket/v1.45/info": dial unix /var/run/docker.sock: connect: no such file or directory 或 connection refused。
问题不在 Docker Desktop 设置界面是否勾选了“Use the WSL 2 based engine”,而在于 WSL 发行版是否真正挂载了 Docker 的 socket 文件系统。Docker Desktop 依赖 \wsl$docker-desktop-data 这个 UNC 路径被正确映射并可读写。
实操建议:
• 在 PowerShell 中运行 Get-ChildItem wsl$,确认 docker-desktop-data 和 docker-desktop 存在且可列出子目录
• 进入任意 WSL 发行版(如 Ubuntu),执行 ls -l /var/run/docker.sock —— 如果返回 “No such file or directory”,说明集成未就绪
• 手动触发重挂载:在 PowerShell 中运行 wsl --terminate docker-desktop-data,再等 10 秒,Docker Desktop 通常会自动重建
WSL 集成开关反复自动关闭
Docker Desktop 设置里的 “Enable integration with my default WSL distro” 开关点开又变灰,或保存后重启即失效,这不是 UI Bug,而是底层校验失败。Docker Desktop 每次启动都会调用 wsl.exe -d docker-desktop-data -- cd / 测试发行版可用性,只要这个命令超时或返回非零退出码,开关就会回退。
关键检查点:
• docker-desktop-data 发行版是否处于 Stopped 状态(wsl -l -v 中显示)?如果是,wsl -t docker-desktop-data 后再 wsl -d docker-desktop-data 尝试手动启动
• 是否存在多个 WSL 发行版共用同一套 ext4.vhdx?某些迁移/克隆操作会导致 docker-desktop-data 的注册路径指向一个已损坏的磁盘文件
• Windows 用户账户控制(UAC)是否被设为“从不通知”?这会导致 WSL 启动时权限提升失败,静默卡住
实操建议:
• 删除损坏的发行版:wsl --unregister docker-desktop-data,然后重启 Docker Desktop,它会自动重建
• 不要手动修改 \wsl$docker-desktop-dataetcwsl.conf,尤其避免添加 automount=false 或自定义 root 路径
• 确保当前 Windows 用户对 C:Users{user}AppDataLocalDockerwsldata 有完全控制权限
如何验证 WSL 集成是否真稳定
别只看 Docker Desktop 图标是否绿色,更要看它能不能扛住真实负载。很多环境看似“能跑容器”,但一执行 docker build 或挂载大量 volume 就断连,根源是 WSL 的内存/IO 调度策略没调好。
容易被忽略的三点:
• WSL 默认不限制内存,但 Docker Desktop 的 docker-desktop-data 发行版若长期占用 >3GB RAM,Windows 可能触发内存压缩,导致 wsl.exe 进程被挂起数秒,socket 连接中断
• /etc/wsl.conf 中的 swap=0 和 localhostForwarding=true 必须显式设置,否则高并发端口转发场景下容易丢包
• wsl --update 升级后,必须执行 wsl --shutdown,不能只靠重启 Docker Desktop;否则旧内核仍在运行,新功能(如 AF_UNIX socket 支持)不会生效
实操建议:
• 在 WSL 发行版中运行 free -h 和 iostat -x 1,观察构建镜像时是否有持续 swap 使用或 %util 接近 100%
• 编辑 /etc/wsl.conf(需先 wsl -t 终止所有发行版),加入:
[wsl2]<br>memory=2GB<br>swap=0<br>localhostForwarding=true
• 每次
wsl --update 后,强制执行 wsl --shutdown,再验证 wsl -l -v 中所有发行版状态是否为 Running


















