Docker拉取失败会残留临时层，需启用BuildKit并配置自动垃圾回收，配合docker builder prune等命令定期清理，结合--pull=always、--no-cache及超时控制预防残留。
拉取失败时，Docker 会在 /var/lib/docker/tmp 或构建上下文缓存中留下未完成的临时层和中间文件，这些不会自动清除，久而久之会占用空间且干扰后续操作。关键不是等失败后再手动删，而是让 Docker 在失败时自动丢弃不完整状态。
启用 BuildKit 并配置自动清理策略
现代 Docker 默认启用 BuildKit（19.03+），它对拉取和构建过程有更精细的状态管理。确保已启用并配置自动回收：
- 检查是否启用：
docker info | grep "BuildKit"，输出应为BuildKit: true - 在
/etc/docker/daemon.json中添加自动垃圾回收设置：
{ "builder": { "gc": { "defaultKeepStorage": "1g", "enabled": true } } } - 重启生效：
sudo systemctl restart docker
拉取失败后立即触发临时层清理
Docker 不会自动删失败拉取产生的临时 blob，但可通过以下命令主动回收：
- 清理所有未完成的拉取/构建临时数据：
docker builder prune -f - 更彻底（含中断中的构建）：
docker builder prune -a -f - 配合镜像清理，一并处理悬空残留：
docker image prune -f
避免残留：用 --pull=always + --no-cache 控制拉取行为
在 CI/CD 或脚本中拉取前加约束，减少失败后状态混乱：
- 强制刷新拉取（跳过本地缓存干扰）：
docker pull --pull=always nginx:latest - 构建时禁用缓存，避免中间层堆积：
docker build --no-cache -t app . - 超时控制（防卡死）：
timeout 300 docker pull redis:7.2（Linux/macOS）
定期验证与监控残留情况
临时残留不易察觉，建议加入运维巡检：
- 查看临时空间占用：
du -sh /var/lib/docker/tmp - 检查是否有孤立 blob：
docker system df -v | grep -A5 "Build cache" - 写入定时任务（如每天清一次）：
0 3 * * * docker builder prune -f > /dev/null
