Docker构建执行RUN npm install时卡住无报错未生成镜像问题求助

• 网络问题导致npm依赖安装卡住：默认npm官方源在国内访问速度极慢，而Docker Buildkit默认的简洁输出模式不会打印npm安装的实时日志，所以看起来构建无反应、没有报错也没有生成最终镜像，你的日志停在[4/4] RUN npm install就是还在执行安装步骤未完成。
• Dockerfile指令顺序不合理：你先复制全部项目文件再安装依赖，若未配置.dockerignore排除本地的node_modules目录，会把本地Windows环境的依赖包复制到Linux镜像中，引发依赖冲突导致安装无响应，同时也会破坏Docker的层缓存机制。
• 部分带二进制文件的npm包兼容性问题：部分npm包会根据系统拉取对应预编译文件，Windows环境下构建时如果网络不稳定拉取对应Linux版本的二进制文件失败，也会导致安装步骤卡住。

• 优化Dockerfile配置，调整指令顺序并指定国内npm源加速安装：

FROM node
WORKDIR /app
# 先复制package相关文件，依赖安装层可复用缓存
COPY package*.json ./
# 用国内npm源加速，避免官方源访问慢的问题
RUN npm install --registry=https://registry.npmmirror.com
# 依赖安装完成后再复制其余业务代码
COPY . .
EXPOSE 3000
CMD ["node", "app.js"]

• 在Dockerfile同级目录创建.dockerignore文件，添加以下内容排除不需要复制到镜像的文件：

node_modules
npm-debug.log
.git
.vscode

• 执行构建命令时加上参数输出详细日志，方便定位问题：
  docker build --progress=plain .
• 如果仍然存在卡住问题，可以直接运行node基础镜像手动执行安装步骤排查具体错误：
  docker run -it --rm -v ${PWD}:/app node bash -c "cd /app && npm install --registry=https://registry.npmmirror.com"

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