Docker构建镜像时卡在加载Dockerfile环节的问题求助
2026-6-22
Docker构建卡在加载Dockerfile/.dockerignore阶段的排查方案
问题现象
在GNU/Linux系统中执行Docker构建时，卡在以下步骤无进展：
=> [internal] load build definition from dockerfile => [internal] load .dockerignore
已尝试--no-cache、docker system df、docker builder prune等命令无效，但其他Docker操作（拉取镜像、列镜像/容器）正常，使用最简Dockerfile仍复现问题。
排查与解决步骤
检查构建上下文
- 用
du -sh .查看当前构建目录大小，确认是否存在大文件/目录（如日志、备份）拖慢加载。 - 检查
.dockerignore配置：确保没有错误排除Dockerfile，也没有意外包含大量无关文件。比如错误的通配符可能导致整个目录被纳入构建上下文。
- 用
重启Docker服务并查看日志
- 重启Docker守护进程：
sudo systemctl restart docker，修复可能的进程异常。 - 实时监控Docker日志：
journalctl -u docker.service -f，执行构建命令时观察是否有权限错误、文件系统异常等日志输出。
- 重启Docker守护进程：
验证文件系统与权限
- 用
df -h检查磁盘是否已满，磁盘空间不足会导致文件读取卡住。 - 确认当前用户对Dockerfile、
.dockerignore及构建目录有读写权限：ls -l Dockerfile .dockerignore，必要时用chmod调整权限。
- 用
切换构建后端
- 关闭BuildKit后端，使用传统构建方式测试：
部分场景下BuildKit的兼容性问题会导致加载卡住。DOCKER_BUILDKIT=0 docker build .
- 关闭BuildKit后端，使用传统构建方式测试：
测试最简构建场景
- 创建空目录，写入极简Dockerfile：
执行FROM python:3.10-slim CMD ["echo", "test"]docker build .，若仍卡住，说明问题可能出在Docker本身或系统环境，而非构建上下文内容。
- 创建空目录，写入极简Dockerfile：
升级Docker版本
- 用
docker --version查看当前版本，若版本较旧，升级到官方稳定版，部分旧版本存在构建阶段的已知bug。
- 用
内容的提问来源于stack exchange，提问作者Robert-Nicolae Solca
相关产品推荐
相关产品推荐
