Docker构建失败时如何确定最后成功的镜像层

这个问题是因为Docker 20.10版本默认启用了BuildKit构建引擎——它优化了构建速度和资源占用，但默认隐藏了中间镜像的详细输出格式。下面是几种快速定位最后成功镜像的实用方法：

方法1：临时禁用BuildKit，恢复旧构建模式 #

直接在构建命令前加入DOCKER_BUILDKIT=0环境变量，就能回到旧版本的输出逻辑，显示每个步骤的镜像ID和中间容器信息：

DOCKER_BUILDKIT=0 docker build -t your-target-image .

构建失败后，你会看到熟悉的---> <镜像ID>格式输出，找到最后一行成功执行的步骤对应的镜像ID，用它启动容器排查：

docker run -it <最后成功的镜像ID> /bin/sh

方法2：保留BuildKit，启用plain输出模式 #

如果你想继续用BuildKit的性能优势，只需在构建时添加--progress=plain参数，就能强制显示完整的步骤细节，包括每个成功步骤的镜像标识：

docker build --progress=plain -t your-target-image .

输出里会明确展示每个步骤对应的镜像ID，找到失败步骤之前最后一个成功的镜像ID即可。

方法3：通过镜像列表筛选最近创建的镜像 #

如果上面的方法没拿到ID，还可以通过镜像创建时间来定位。最后成功的镜像通常是构建过程中最新生成的那个：

docker images --format "{{.ID}} {{.CreatedSince}}" | sort -k2

找到创建时间最近的镜像ID，尝试启动它排查问题。如果构建依赖了旧缓存，建议先执行docker builder prune清理缓存后重新构建，确保最新镜像就是最后成功的层。

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