docker-compose启动Node.js服务报Cannot find module 'express'错误如何解决

问题核心是docker-compose配置的绑定挂载覆盖了镜像内部的依赖文件：

• Dockerfile构建阶段执行npm install时，所有依赖包都会被安装到镜像内的/usr/src/app/node_modules路径
• docker-compose启动时，你配置的绑定挂载会将本地./user-service目录的内容直接覆盖容器内的/usr/src/app路径，如果本地项目目录没有提前生成和容器环境匹配的node_modules，挂载后容器内的依赖目录就会消失
• 单独执行docker run时没有配置挂载规则，使用的是镜像内完整的文件结构，因此运行正常

以下方案按优先级从高到低排列：

方案1：新增匿名卷保留镜像内的依赖（推荐） #

在docker-compose的volumes配置中新增一行匿名卷规则，让容器内的/usr/src/app/node_modules路径不被本地挂载覆盖，同时保留其他文件的热重载能力：

user: 
    build: ./user-service
    ports: 
        - "2008:3000"
    volumes:
        - type: bind
          source: ./user-service
          target: /usr/src/app
        - /usr/src/app/node_modules # 新增该规则，优先级高于外层绑定挂载
    working_dir: /usr/src/app
    networks: 
        - backend

修改后执行docker-compose up --build重启即可生效。

方案2：本地提前安装依赖 #

直接在本地的./user-service目录下执行npm install，将依赖安装到本地node_modules中，挂载后容器可直接读取。
注意该方案可能存在跨系统兼容性问题：如果你的本地系统是Windows/Mac，容器运行环境是Linux，部分带原生编译逻辑的依赖包可能无法正常运行。

方案3：将依赖安装到容器非挂载目录 #

修改Dockerfile，把依赖安装到容器内不会被挂载的路径，通过环境变量指定依赖读取位置，从根源避免被挂载覆盖：

FROM node:12

RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app

COPY package.json /usr/src/app
# 将依赖安装到根目录的node_modules
RUN npm install --prefix /node_modules
# 配置Node依赖读取路径
ENV NODE_PATH=/node_modules/node_modules

COPY . /usr/src/app

EXPOSE 3000
CMD ["npm", "run", "dev"]

该方案适合对依赖稳定性要求高，不需要在容器内修改依赖的场景。

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