Dockerfile构建镜像启动容器时CMD指令未执行如何排查解决

• 第二阶段构建时仅在项目目录局部安装serve，当前CMD使用exec语法编写，不会启动shell环境做依赖路径自动解析，npx启动时无法直接命中局部安装的serve包，会触发临时远程拉取逻辑，受容器默认网络限制、权限策略影响极易启动失败直接退出，表现为容器启动后立刻退出，看起来和CMD未执行一致；手动通过exec进入容器时默认加载shell交互环境，可自动识别当前项目下的局部依赖，因此手动执行命令可正常运行。
• 未明确指定serve监听地址为0.0.0.0，部分Docker环境下服务默认绑定本地回环地址或IPv6地址，会导致宿主机无法正常访问容器内服务。

调整第二阶段依赖安装逻辑和启动命令，修改后的完整Dockerfile如下：

FROM node:16 as builder
WORKDIR /app
COPY ./package*.json ./
RUN npm install
COPY . .
RUN npm run build

FROM node:16
WORKDIR /app
# 全局安装静态服务，规避局部依赖的路径解析问题
RUN npm install -g serve
# 拷贝构建产物到工作目录
COPY --from=builder /app/build ./
# 明确指定监听3000端口，以当前目录为静态资源根目录启动服务
CMD ["serve", "-l", "3000", "."]

如果是React/Vue等单页应用，需要支持前端路由的话，给启动命令加-s参数即可，即CMD ["serve", "-s", "-l", "3000", "."]。

如果修改后仍有异常，启动容器时先不要加-d后台运行参数，以前台模式启动直接查看控制台输出日志，例如执行docker run --rm -p 3000:3000 自定义镜像名，可直接看到服务启动的完整输出和报错信息，无需靠猜测定位问题。

内容的提问来源于stack exchange，提问作者Şükrü Karadağ