Docker构建缓存占用14.59GB但可回收空间为0，如何清理？

问题现象 #

执行docker system prune --all后输出如下，构建缓存全部处于ACTIVE状态，无法回收，占用14.59GB空间：

TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 0 0 0B 0B
Containers 0 0 0B 0B
Local Volumes 0 0 0B 0B
Build Cache 40 40 14.59GB 0B

解决步骤 #

• 优先使用构建器专属清理命令
  执行以下命令强制清理所有构建缓存：

  docker builder prune --all --force
  

  --all会清理所有未被使用的构建缓存，--force跳过确认提示。

• 检查并终止活跃构建会话
  运行docker buildx ls查看是否有正在运行的构建器会话，如果存在未完成的构建任务，先终止相关进程，再重新执行清理命令。

• 手动清理构建缓存目录（谨慎操作）
  若上述命令无效，可手动删除构建缓存存储目录：

  1. 停止Docker服务：

     # Linux系统
     sudo systemctl stop docker
     # Windows/macOS可通过Docker Desktop界面停止服务
     

  2. 删除构建缓存目录（路径根据系统调整）：

     # Linux
     sudo rm -rf /var/lib/docker/buildkit/*
     # Windows
     rmdir /s /q C:\ProgramData\Docker\buildkit
     # macOS
     rm -rf ~/Library/Containers/com.docker.docker/Data/vms/0/data/docker/buildkit/*
     

  3. 重启Docker服务：

     sudo systemctl start docker
     

• Docker Desktop GUI清理
  打开Docker Desktop，依次进入「设置」→「资源」→「磁盘用量」，点击「清理」按钮，勾选「构建缓存」后执行清理。

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