Docker镜像构建中断主因是RUN指令网络请求被临时打断，非代码问题；需配置国内镜像加速器（如https://docker.m.daocloud.io）、优化构建阶段内部源（如Ubuntu换apt源、Node换npm源）、启用DOCKER_BUILDKIT=1及脚本化指数退避重试。
Docker 镜像构建中断，多数不是代码或语法问题，而是网络链路在 RUN 指令执行时（比如 apt update、pip install、npm install）被临时打断。这类中断本质是构建过程中发起的外部网络请求失败，而非镜像本身不可用，可通过分层优化+容错配置快速缓解。
配置国内镜像加速器（解决基础拉取卡顿）
这是最优先要做的一步——它直接影响 FROM 基础镜像的下载成功率。
- 编辑 /etc/docker/daemon.json（Windows Docker Desktop 在 Settings → Docker Engine 中修改），填入稳定加速地址：
{"registry-mirrors": ["https://docker.m.daocloud.io", "https://docker.xuanyuan.me", "https://docker.mirrors.tuna.tsinghua.edu.cn"]}- 保存后运行 sudo systemctl restart docker（Linux）或点击 Apply & Restart（Windows/macOS）
- 验证：执行
docker info | grep -A 1 "Registry Mirrors"，确认已生效
优化构建阶段内部源（应对 RUN 中的网络请求）
registry-mirrors 只管镜像拉取，不管容器内 `RUN` 指令发起的包管理请求。必须按基础镜像类型单独换源：
-
Debian/Ubuntu：在 RUN 前插入换源命令，例如：
RUN sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list \&\& apt update -
CentOS/RHEL：替换
/etc/yum.repos.d/*.repo中 baseurl 为清华或阿里云源 -
Node.js：加一行
RUN npm config set registry https://registry.npmmirror.com -
Python/pip：加
RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
启用构建增强机制（提升调度鲁棒性）
Docker 自 24.0 起默认启用更健壮的构建器，可配合环境变量进一步加固：
- 构建时加环境变量：
DOCKER_BUILDKIT=1 docker build -t myapp . - 该模式下分层下载与执行解耦，单层失败不会导致整个构建回滚，且支持断点续传式恢复
- 如需降低并发压力，可额外设：
export DOCKER_BUILDKIT=1 BUILDKIT_PROGRESS=plain
脚本化重试（CI/CD 流水线推荐）
对关键构建任务，封装带判断的重试逻辑，只对可恢复错误重试（如连接超时、502/503）：
- 示例（Bash）：
for i in $(seq 1 3); do if docker build -t myapp .; then exit 0; else sleep $((2 ** i)); fi; done- 不建议盲目重试 401 或 404 错误——它们反映的是凭证或镜像不存在，重试无意义
