Windows版Docker Desktop添加.wslconfig后启动失败问题求助

故障背景 #

故障触发场景为Windows系统下手动编辑.wslconfig文件限制WSL2资源占用后，Docker Desktop启动时报错：
It look like there is an error with Docker Desktop,restart it to fix it.
初始触发故障的.wslconfig配置存在格式问题，后续多次排查未彻底解决：

• 删除.wslconfig文件后故障未消失
• 卸载后切换Hyper-V后端重装，重启电脑后故障依旧
• 清空本地Docker配置缓存目录后可临时正常启动，重启电脑后故障复现
• 故障环境为Docker Desktop 4.9.0版本

根因说明 #

两个核心问题共同导致故障反复出现：

1. WSL2的.wslconfig配置文件不支持行内注释，最初带#行内注释的配置会被WSL识别为非法格式，直接导致WSL后端初始化失败，后续即使删除配置文件，损坏的WSL状态和Docker配置缓存也没有被完全清理
2. Docker Desktop 4.9.0版本存在已知的配置持久化bug，系统重启时如果Docker服务加载早于WSL/Hyper-V虚拟化服务，会读取到损坏的配置缓存触发启动报错，清空缓存只是临时解决，下次重启时序不对就会复现

修复步骤 #

优先方案：升级到稳定版本永久修复 #

4.9.0属于4.x早期迭代版本，该类启动bug在后续版本已经完全修复，操作步骤：

1. 完全退出Docker Desktop，打开系统「应用和功能」找到Docker Desktop，选择卸载，卸载时勾选「删除所有镜像、容器和配置数据」选项
2. 重启电脑，确保系统虚拟化功能（WSL/Hyper-V）处于正常启用状态
3. 安装4.12及以上版本的Docker Desktop稳定版，首次启动完成初始化后，直接在Docker Desktop设置-资源页面调整CPU、内存限制，不需要手动编辑.wslconfig文件

保留4.9.0版本的手动修复方案 #

如果因特殊需求必须使用4.9.0版本，按以下步骤操作：

1. 打开任务管理器，结束所有Docker相关进程，包括后台的com.docker.service服务
2. 打开当前用户的个人目录（路径为C:\Users\[你的Windows用户名]），如果保留.wslconfig文件，必须删除所有行内注释，合法格式参考：

[wsl2]
memory=3GB
processors=4

3. 以管理员身份打开命令提示符，依次执行以下命令重置服务状态：

wsl --shutdown
sc stop com.docker.service
icacls "C:\Program Files\Docker\Docker" /grant Users:F /T
sc start com.docker.service

4. 进入以下三个路径，删除路径下的所有文件和子文件夹，不要删除目录本身：
   • C:\Users\[你的用户名]\AppData\Local\Docker
   • C:\Users\[你的用户名]\AppData\Roaming\Docker
   • C:\Users\[你的用户名]\AppData\Roaming\Docker Desktop
5. 右键点击Docker Desktop快捷方式，打开属性-兼容性面板，勾选「以管理员身份运行此程序」保存设置
6. 打开Docker Desktop设置，关闭「开机时自动启动Docker Desktop」选项，手动把Docker Desktop快捷方式复制到系统启动目录C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp，保证系统启动时虚拟化服务加载完成后再启动Docker，避免时序问题触发故障。

校验：操作完成后手动重启电脑2-3次，确认Docker可以正常启动即为修复成功。

内容的提问来源于stack exchange，提问作者Divyank