先确认 docker-desktop wsl 分发版是否完好：执行 wsl --list --verbose，检查 docker-desktop 是否存在且状态为 running、docker-desktop-data 是否存在且版本为 2；若显示 uninstalling、stopped 或缺失，则需管理员 powershell 中依次执行 wsl --shutdown、wsl --unregister docker-desktop、wsl --unregister docker-desktop-data，再重启 docker desktop 自动重建。
容器启动失败时先确认 docker-desktop WSL 分发版是否完好
很多“容器启不来”的表象，其实是底层 docker-desktop 这个 WSL2 发行版已损坏或状态异常。它不运行，Docker Engine 就根本起不来，自然所有容器都卡在 starting 或直接报错退出。
以管理员身份打开 PowerShell，执行：
wsl --list --verbose
重点看两行：
-
docker-desktop是否在列表中？状态是不是Running？ -
docker-desktop-data是否存在且版本为2？
如果 docker-desktop 显示 Uninstalling、Stopped 但无法启动，或干脆不在列表里，说明它已失效——此时任何对单个容器的 docker start 都会静默失败或报 Cannot connect to the Docker daemon。
重置前必须手动终止并清理残留 WSL 实例
直接点托盘图标里的 Reset to factory defaults 有时无效，因为 docker-desktop 分发版本身卡在异常状态，重置流程无法正常接管。
务必按顺序执行以下操作：
- 右键托盘图标 →
Quit Docker Desktop（不是关闭窗口，是彻底退出进程） - PowerShell（管理员）中运行：
wsl --shutdown，等 5 秒 - 再手动删掉坏掉的发行版：
wsl --unregister docker-desktop和wsl --unregister docker-desktop-data - 删完后，重启 Docker Desktop —— 它会自动重建这两个分发版
这步跳过会导致重置后仍卡在 Starting the Docker engine，因为旧的锁文件或 socket 还占着资源。
docker start 返回成功但容器立刻退出？检查日志和入口命令
如果容器能被 docker start 命令“接受”，但马上变成 Exited (1) 状态，问题不在 Docker 引擎，而在容器自身。
快速定位方法：
- 运行
docker logs <container_name></container_name>，看最后几行有没有明确报错（比如配置文件路径不存在、端口被占、exec format error） - 用
docker inspect <container_name></container_name>查Config.Cmd和Config.Entrypoint，确认你没误删了启动命令或挂载了错误的配置卷 - 如果是自己写的镜像，检查
Dockerfile中的CMD是否写成后台运行（如nginx -g "daemon off;"），否则容器启动即退出
常见陷阱：Windows 用户挂载本地路径时用了反斜杠 \，导致配置文件读取失败，但错误不会直接打在终端里，只出现在 logs 中。
保留镜像但容器无法复用？检查 wsl\data 目录权限和磁盘空间
重置时勾选了 Keep my images and containers，但重启后 docker ps -a 里空空如也——大概率是 %LOCALAPPDATA%\Docker\wsl\data\ 目录权限异常或磁盘空间不足。
这个目录实际保存着所有容器元数据（不是镜像），Docker Desktop 重启后需要重新加载它。若该目录被杀毒软件锁定、或所在磁盘剩余空间
验证方式：
- 进资源管理器，手动打开
%LOCALAPPDATA%\Docker\wsl\data\，看能否列出文件（如ext4.vhdx） - 右键 → 属性 → 安全 → 确认当前用户有“完全控制”权限
- 检查 C 盘剩余空间，低于 10GB 时建议先清理再试
这个目录不像镜像那样显眼，出问题时极少被想到，但它一堵，整个容器生命周期管理就断链了。
