执行docker system prune时报read-only file system错误求助

DevOps 小满

2026-10-18

报错原因

该报错属于Windows版Docker Desktop 3.x版本的已知偶发问题，本质是WSL2后端存储挂载异常被锁定为只读状态，通常由异常关机、存储分区容量耗尽、Docker后台进程异常中断触发。

解决方案

首先完全退出Docker Desktop：右键系统托盘的Docker图标，选择Quit Docker Desktop，等待所有Docker相关后台进程退出
重启WSL2后端：以管理员身份打开Windows终端/命令提示符，执行以下命令：
```
wsl --shutdown
```
等待30秒后，执行wsl命令确认WSL2正常启动，即可关闭终端
重新打开Docker Desktop，等待左下角状态显示为绿色Running后，重新执行清理命令即可：
```
docker system prune
```
若上述操作后仍报错，可先尝试单独清理构建缓存替代全量资源清理：
```
docker builder prune
```
若问题仍然存在，可重置Docker Desktop配置：打开Docker Desktop设置 -> Troubleshoot -> 选择Reset to factory defaults。注意该操作会清除本地所有镜像、容器、存储卷数据，操作前请提前备份需要保留的资源。