Docker运行Node.js Express服务器报错：找不到/app/index.js模块

排查及解决步骤 #

1. 检查.dockerignore配置 #

如果本地存在.dockerignore文件，确认它没有排除index.js或项目源码文件。比如文件里如果写了*、index.js这类规则，会导致COPY . .无法将文件复制到容器内。

• 处理方式：打开.dockerignore，删除影响源码复制的规则，建议只忽略node_modules/、.git/、.env这类不需要打包进镜像的内容。

2. 确认Docker构建上下文路径 #

执行docker build命令时，你所在的目录必须是包含index.js和Dockerfile的项目根目录。如果在子目录执行构建，COPY . .只会复制子目录的内容，容器的/app下自然找不到根目录的index.js。

• 处理方式：切换到项目根目录后，再执行构建命令：

  docker build -t your-image-name .
  

3. 验证容器内文件是否存在 #

启动容器的交互式shell，直接查看/app目录的内容，确认index.js是否被正确复制：

docker run -it --rm your-image-name /bin/bash
# 进入容器后执行
ls /app

如果输出里没有index.js，回到前两步重新检查构建上下文和.dockerignore配置。

4. 优化依赖安装方式（可选） #

你的Dockerfile用RUN npm install express手动安装依赖，更规范的做法是通过package.json管理：

• 本地执行命令将express添加到依赖：

  npm install express --save
  

• 修改Dockerfile的安装步骤为：

  RUN npm install
  

  这种方式更符合Node.js项目的依赖管理逻辑，也能避免手动安装遗漏问题。

5. 确认CMD命令的文件路径 #

如果index.js不在项目根目录（比如放在src/子文件夹），需要调整CMD的路径，例如：

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

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