EC2实例中Docker Build执行npm install时卡住的解决请求

在EC2实例上构建Docker镜像时，npm install步骤总是卡住，即使把该命令写入bash脚本执行也无法解决。

现有文件内容 #

Dockerfile #

FROM node
WORKDIR /App
COPY package*.json /tmp/
COPY . .
CMD ["/usr/bin/bash"]
COPY bash.sh /tmp/
RUN bash /tmp/bash.sh
EXPOSE 3000
CMD ["npm","run","start"]

bash.sh #

npm install

构建输出 #

DEPRECATED: The legacy builder is deprecated and will be removed in a future release.
            Install the buildx component to build images with BuildKit:
            https://docs.docker.com/go/buildx/

Sending build context to Docker daemon   7.06MB
Step 1/9 : FROM node
 ---> 8d6c41e6504f
Step 2/9 : WORKDIR /App
 ---> Using cache
 ---> dc60237f627c
Step 3/9 : COPY package*.json /tmp/
 ---> Using cache
 ---> bbd013f7bc5e
Step 4/9 : COPY . .
 ---> e28beed562c8
Step 5/9 : CMD ["/usr/bin/bash"]
 ---> Running in 9cb0e7128c36
Removing intermediate container 9cb0e7128c36
 ---> 0a59fdf80b76
Step 6/9 : COPY bash.sh /tmp/
 ---> a4bf4c096fb3
Step 7/9 : RUN bash /tmp/bash.sh
 ---> Running in 44a816da40ae

1. 修正Dockerfile的指令错误与优化 #

你的Dockerfile存在几个明显问题，直接导致构建流程异常：

• 中间插入的CMD ["/usr/bin/bash"]完全多余，CMD是容器启动时执行的指令，构建阶段无效，还会打乱缓存逻辑
• package*.json被复制到/tmp，但npm install默认读取当前工作目录的配置文件，相当于没正确利用依赖缓存
• 没必要用bash脚本封装npm install，增加冗余步骤

修正后的Dockerfile：

FROM node
WORKDIR /App
# 优先复制package文件，利用Docker缓存机制，只要依赖配置不变就不会重复执行npm install
COPY package*.json ./
# 可选：切换为国内npm镜像，解决网络延迟导致的卡顿
RUN npm config set registry https://registry.npmmirror.com/
# 直接执行npm install
RUN npm install
# 复制项目其余代码
COPY . .
EXPOSE 3000
CMD ["npm","run","start"]

2. 排查EC2网络问题 #

npm install卡住大概率是网络原因：

• 检查EC2实例的安全组，确保允许**出站HTTPS（443端口）**访问，npm仓库需要通过HTTPS拉取依赖
• 在EC2实例本地直接执行npm install，验证是否能正常下载依赖，排除实例本身的网络故障
• 如果使用私有npm仓库，需要在Dockerfile中添加认证配置，比如复制本地的.npmrc文件到容器：

COPY .npmrc ./

3. 查看详细构建日志 #

构建时添加--progress=plain参数，能看到npm install的具体执行日志，定位卡住的具体环节：

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

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