Docker部署Node.js项目报错：Cannot find module 'express'求助

可能的原因及修复步骤 #

1. 确认package.json中包含express依赖 #

先检查本地package.json文件，确保dependencies字段里存在express的配置条目，示例如下：

{
  "dependencies": {
    "express": "^4.18.2"
  }
}

如果没有该条目，在项目根目录执行以下命令添加依赖：

npm install express --save

完成后重新构建镜像。

2. 检查docker-compose.yml的卷配置是否覆盖容器内的node_modules #

如果你的docker-compose.yml中有类似下面的挂载配置：

services:
  app:
    build: .
    volumes:
      - .:/usr/src/app

这种配置会把本地目录（包括可能为空的本地node_modules）覆盖容器内已安装好依赖的node_modules目录。修复时添加匿名卷保留容器内的依赖目录即可：

services:
  app:
    build: .
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules

3. 强制重新构建镜像，清除缓存 #

Docker会缓存RUN npm install步骤，若之前的缓存中未安装express，即便修改了package.json也不会自动重新安装。执行以下命令强制清理缓存并重新构建：

docker-compose build --no-cache
docker-compose up

4. 验证Dockerfile执行顺序（你的配置已正确，仅需确认） #

你的Dockerfile执行顺序是规范的：先复制package*.json文件，执行依赖安装，最后复制项目代码。这种顺序能保证依赖安装步骤可被合理缓存，仅当package.json变动时才会重新执行npm install。若之前存在错误的构建缓存，清理后重新构建即可解决问题。

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