Windows 怎么排查 Docker 容器因磁盘配额超出写入失败故障-windows运维-PHP中文网

wsl2虚拟磁盘空间耗尽导致docker写入失败，需通过docker system prune清理、清空日志、wsl --shutdown释放空间，并配置日志限制与.wslconfig扩容来解决。

windows 上 docker 容器因磁盘配额超出导致写入失败，本质是 wsl2 虚拟机的磁盘空间耗尽（而非 windows 本机磁盘），常见于长期运行或日志未轮转的容器。这类问题表现为容器内应用报 “no space left on device”、“permission denied”（实际非权限问题）或写文件直接失败，但 windows 资源管理器显示 c 盘仍有大量剩余空间。

确认是 WSL2 磁盘空间不足

Windows 的 Docker Desktop 默认使用 WSL2 后端，所有镜像、容器层、日志都存储在 WSL2 发行版的虚拟磁盘中（如 \wsl$docker-desktop-dataext4.vhdx），该文件会自动增长但有上限（默认约 256GB，受 WSL 配额限制）。

打开 PowerShell，执行：
wsl -l -v → 确认 docker-desktop-data 正在运行
进入 WSL2 环境：
wsl -d docker-desktop-data
在 WSL 内检查磁盘使用：
df -h / → 关注 / 或 /var/lib/docker 使用率是否 ≥95%
退出 WSL：
exit

快速释放 WSL2 磁盘空间

无需重装或手动删文件，优先用 Docker 命令清理：

Docker Desktop

Docker Desktop 可用于构建容器化 PHP 开发环境，适合 Laravel、Symfony、WordPress 等项目统一运行依赖。

下载

清理无用镜像、停止的容器、构建缓存：
docker system prune -a --volumes（加 --volumes 可删未使用的卷）
单独清理容器日志（WSL 中日志也占大空间）：
find /var/lib/docker/containers/ -name "*.log" -exec truncate -s 0 {} ;
若仍满，重启 WSL2 释放已删除但未回收的空间：
PowerShell 中执行：
wsl --shutdown → 再次启动 Docker Desktop

防止再次触发配额限制

WSL2 的 ext4.vhdx 文件不会自动收缩，需主动干预：

限制容器日志大小（推荐）：
编辑 %USERPROFILE%AppDataRoamingDockersettings.json，添加：
"daemonConfig": {"log-driver": "json-file", "log-opts": {"max-size": "50m", "max-file": "3"}} → 重启 Docker Desktop
定期压缩 WSL2 虚拟磁盘：
关闭所有 WSL 实例后，在 PowerShell 运行：
wsl --shutdown
wsl -d docker-desktop-data --export .dd-export.tar
wsl --unregister docker-desktop-data
wsl --import docker-desktop-data "$env:USERPROFILEAppDataLocalDockerwsldata" .dd-export.tar --version 2
扩容 WSL2 配额（如需）：
创建 %USERPROFILE%wslconfig.wslconfig，加入：
```
[wsl2]<br>diskSize = 100GB
```
→ 重启 WSL

验证写入是否恢复

清理后测试真实写入能力，避免假性恢复：

运行一个临时容器写测试文件：
docker run --rm -v testvol:/data alpine sh -c "dd if=/dev/zero of=/data/test.bin bs=1M count=100 2>/dev/null && echo 'OK' || echo 'FAIL'"
若输出 OK，说明底层存储已可用；若仍 FAIL，检查是否挂载了 :ro 或容器内用户无权限（见只读挂载与 UID 匹配问题）