Docker构建Express REST API镜像卡在RUN阶段问题求助

核心问题 #

你的Dockerfile中使用了RUN npm start，这个指令会在镜像构建阶段启动Express服务。但Express服务属于常驻进程，启动后不会自动退出，直接导致构建过程卡在该步骤，永远无法完成。

修复方案 #

直接删除RUN npm start这一行，应用启动逻辑交给CMD指令处理即可，修改后的Dockerfile如下：

FROM node:20.14.0

WORKDIR /user/src/app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 3000

CMD ["node", "index.js"]

关键区别说明 #

• RUN：仅在镜像构建阶段执行，用于完成安装依赖、编译代码等一次性操作，执行后必须退出进程，否则构建会卡住。
• CMD：在容器启动阶段执行，用来启动应用主进程，这个进程会持续运行直到容器停止，符合Express服务的运行逻辑。
• 如果你的应用需要数据库同步操作，应将该逻辑写在index.js中（比如启动服务前先执行同步），不要放在构建阶段——构建阶段不应依赖外部数据库，也不能执行持续运行的操作。

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