Dockerfile构建镜像后未自动创建并运行容器问题排查

核心误区纠正 #

• docker build . 仅完成镜像构建，不会自动创建或运行容器，必须手动执行docker run命令启动容器。
• 构建成功后输出的是Successfully built <IMAGE_ID>（镜像ID），而非容器ID，你看不到容器ID是正常现象，课程里的表述可能存在口误。

CMD指令的作用说明 #

Dockerfile中的CMD ["npm","run","dev"]是容器启动时默认执行的命令，仅在docker run启动容器阶段生效，docker build过程中不会执行该指令，这就是构建后没有启动应用的直接原因。

WORKDIR与路径问题分析 #

WORKDIR '/app'会将容器内的工作目录设置为/app，只要Dockerfile中正确将本地源码复制到容器的/app目录下，package.json里的dev脚本nodemon src/index.js是完全可行的（相对路径基于/app），不需要修改为绝对路径，建议将你修改后的脚本改回原配置：

"scripts": {
  "dev": "nodemon src/index.js"
}

具体排查步骤 #

1. 确认镜像是否构建成功
   执行以下命令查看本地镜像列表，确认目标镜像存在：

   docker images
   

2. 手动启动容器
   使用以下命令启动容器（替换<IMAGE_ID/NAME>为你的镜像ID或自定义镜像名，端口映射根据你的Node应用端口调整，示例为3000）：

   docker run -p 3000:3000 <IMAGE_ID/NAME>
   

   执行后即可看到npm run dev的启动日志。

3. 检查Dockerfile的文件复制逻辑
   确保Dockerfile包含以下关键步骤，保证源码和依赖正确复制到容器内：

   WORKDIR /app
   # 先复制package.json安装依赖，利用镜像缓存
   COPY package*.json ./
   RUN npm install  # 不要加--production，否则会跳过devDependencies中的nodemon
   # 复制所有源码文件
   COPY . .
   CMD ["npm", "run", "dev"]
   

4. 验证容器内的文件结构与脚本执行
   启动临时容器进入交互式shell，检查文件结构并手动测试脚本：

   docker run --rm -it <IMAGE_ID/NAME> sh
   

   在容器内执行以下命令：

   # 查看/app目录下的文件
   ls /app
   # 手动执行dev脚本，排查是否有报错
   npm run dev
   

   如果执行npm run dev时报错找不到nodemon，说明安装依赖时未包含devDependencies，检查Dockerfile中的RUN npm install是否添加了--production参数，如有则去掉。

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