Docker构建welcome-to-docker镜像卡在最后步骤，请求解决方案

分步排查与修复方案 #

1. 拆分RUN命令定位卡环节点 #

把长命令拆分为独立RUN步骤，明确是npm依赖安装、全局工具部署还是项目构建哪个环节出问题：

RUN npm install
RUN npm install -g serve
RUN npm run build
RUN rm -fr node_modules

重新执行docker build -t welcome-to-docker .，观察具体卡在哪个步骤，缩小问题范围。

2. 排查网络与npm源问题 #

• 进入卡住的容器验证网络：新开终端执行docker ps找到构建中的容器ID，再执行docker exec -it <容器ID> /bin/bash进入容器，尝试ping registry.npmjs.org，确认是否能正常连通官方源。
• 更换国内npm源提速：在Dockerfile的npm install步骤前添加源配置命令：

  RUN npm config set registry https://registry.npmmirror.com
  

3. 优化npm安装的缓存与效率 #

• 利用Docker层缓存：先复制package.json和package-lock.json到容器，再执行npm install，依赖未变更时可复用缓存：

  COPY package*.json ./
  RUN npm install
  COPY . .
  RUN npm run build
  

• 精简安装参数：执行npm install时禁用可选依赖与本地缓存，减少冗余操作：

  RUN npm install --no-optional --no-cache
  

4. 限制构建时的资源占用 #

Ryzen 5 1600为6核CPU，若构建时资源耗尽可能导致卡住：

• 指定构建可用CPU核心数：docker build --cpus 4 -t welcome-to-docker .，避免过度占用系统资源。
• 实时监控资源：用htop命令查看CPU、内存使用率，确认是否存在资源耗尽情况。

5. 验证基础镜像兼容性 #

确保Dockerfile使用的Node.js基础镜像与系统环境兼容，建议指定LTS版本（如node:20-bookworm），避免版本不匹配引发的异常。

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