1. 故障概述现象Docker Desktop 启动后持续弹出WSL integration with distro Ubuntu unexpectedly stopped. Do you want to restart it?同时报错configuring docker in Ubuntu: docker cli config: failed to write file: exit status 0xffffffff2. 环境信息项目信息OSWindows 10 22H2DockerDocker DesktopWSL2 BackendWSLVersion 2已安装发行版Ubuntu、Ubuntu-24.04、docker-desktop3. 排查过程企业标准P1 WSL 状态检查wsl -l -v结果Ubuntu Stopped Ubuntu-24.04 Running docker-desktop Running发现系统存在两个 Ubuntu 发行版Docker Desktop 存在WSL2 正常P2 Docker Engine 验证Windowsdocker version docker infoUbuntudocker version docker run hello-world验证结果Docker Client 正常Docker Engine 正常Docker Hub 拉取正常容器创建正常WSL 与 Engine 通信正常排除Docker Engine 故障Docker 安装失败网络问题P3 Ubuntu 环境检查验证echo $HOME ls -ld ~ ls -la ~/.docker cat ~/.docker/config.json结果HOME 正常用户权限正常.docker自动生成config.json自动生成contexts自动生成features.json自动生成排除HOME 配置错误文件权限异常Docker CLI 配置失败WSL 文件系统异常P4 根因定位发现系统同时存在Ubuntu Ubuntu-24.04其中Ubuntu Stopped Ubuntu-24.04 RunningDocker Desktop 在执行WSL Integration时仍尝试集成旧发行版Ubuntu。由于默认 WSL 发行版及 Docker Integration 指向旧发行版导致 Integration 初始化异常退出并持续触发configuring docker in Ubuntu failed to write file exit status 0xffffffffDocker Engine 实际工作正常仅WSL Integration 指向错误发行版。4. 根本原因Root Cause历史遗留 WSL 发行版Ubuntu与新发行版Ubuntu-24.04同时存在。Docker Desktop WSL Integration 使用了错误的默认发行版导致Integration 初始化失败Docker CLI 配置流程异常退出Desktop UI 持续提示配置失败本质属于 WSL 默认发行版配置问题而非 Docker Engine 故障。5. 解决方案Step 1 设置正确默认发行版wsl --set-default Ubuntu-24.04验证wsl默认进入Ubuntu-24.04Step 2 删除历史遗留发行版确认旧发行版无需保留后wsl --unregister Ubuntu验证wsl -l -v结果Ubuntu-24.04 docker-desktop仅保留当前使用的发行版。Step 3 重启 Docker DesktopDocker DesktopRestartWSL Integration 自动重新初始化。6. 验证结果执行docker version docker infoUbuntudocker version docker run hello-world验证结果✅ Docker Engine 正常✅ Docker CLI 正常✅ WSL Integration 正常✅ Hello World 成功✅ Docker Desktop 不再报错✅ WSL Integration 正常建立7. 经验总结Best Practice一个开发环境建议仅保留一个长期使用的 Linux 发行版避免多个同类型发行版并存。Docker Desktop 依赖WSL 默认发行版进行 Integration安装新发行版后应及时设置默认发行版。删除旧发行版前确认其中无业务数据若有数据应先导出或迁移。排障遵循WSL → Docker Engine → Docker CLI → Integration → UI的顺序避免因 UI 报错误判为 Docker 安装失败。最终结论此故障属于WSL 默认发行版配置错误导致的 Docker Desktop WSL Integration 异常并非 Docker Engine 或 Docker CLI 本身故障。通过将默认发行版切换至Ubuntu-24.04、清理历史遗留Ubuntu发行版并重启 Docker Desktop 后问题彻底解决。