Docker容器运行Node项目提示找不到rimraf模块的问题求助

我之前也碰到过类似的问题，结合你给出的配置和错误日志，咱们来一步步排查：

错误日志 #

Error: Cannot find module 'rimraf' 
node_1 | at Function.Module._resolveFilename (internal/modules/cjs/loader.js:571:15) 
node_1 | at Function.Module._load (internal/modules/cjs/loader.js:497:25) 
node_1 | at Module.require (internal/modules/cjs/loader.js:626:17) 
node_1 | at require (internal/modules/cjs/helpers.js:20:18) 
node_1 | at Object.<anonymous> (/usr/src/app/controllers/products.js:5:16) 
node_1 | at Module._compile (internal/modules/cjs/loader.js:678:30) 
node_1 | at Object.Module._extensions..js (internal/modules/cjs/loader.js:689:10) 
node_1 | at Module.load (internal/modules/cjs/loader.js:589:32) 
node_1 | at tryModuleLoad (internal/modules/cjs/loader.js:528:12) 
node_1 | at Function.Module._load (internal/modules/cjs/loader.js:520:3) 
node_1 | at Module.require (internal/modules/cjs/loader.js:626:17) 
node_1 | at require (internal/modules/cjs/helpers.js:20:18) 
node_1 | at Object.<anonymous> (/usr/src/app/expressRoutes/productRoutes.js:6:26) 
node_1 | at Module._compile (internal/modules/cjs/loader.js:678:30) 
node_1 | at Object.Module._extensions..js (internal/modules/cjs/loader.js:689:10) 
node_1 | at Module.load (internal/modules/cjs/loader.js:589:32) 

你的Dockerfile #

FROM node 
# Create a directory where our app will be placed 
RUN mkdir -p /usr/src/app 
# Change directory so that our commands run inside this new directory 
WORKDIR /usr/src/app 
# Copy dependency definitions 
COPY package.json /usr/src/app 
# Install dependecies 
RUN npm install 
# Get all the code needed to run the app 
COPY . /usr/src/app 
# Expose the port the app runs in 
EXPOSE 4000 
# Serve the app 
CMD ["npm", "start"]

你的docker-compose.yml #

version: '2' 
services: 
  node: 
    image: some-private-repo/node_application:latest 
    ports: 
      - "4000:4000" 
    links: 
      - mongo 
    environment: 
      - MONGO_URL=mongodb://mongo:27017/mydb 
    networks: 
      - network 
    depends_on: 
      - mongo 
  mongo: 
    image: mongo:latest 
    ports: 
      - "27017:27017" 
    networks: 
      - network 

networks: 
  network: 
    driver: bridge

问题原因分析 #

结合这些信息，大概率是以下两个原因之一：

1. rimraf被放在了devDependencies中：
   默认情况下，npm install在生产环境（Docker容器默认是生产环境）会跳过devDependencies里的包。如果你的项目运行时需要用到rimraf（比如启动脚本里调用了它），但你把它装在了devDependencies下，容器里就不会安装这个模块，导致找不到。

2. 本地node_modules被复制到了容器中：
   你没有配置.dockerignore文件排除node_modules目录，导致执行COPY . /usr/src/app时，本地的node_modules被复制到了容器里。本地的node_modules是基于你的主机系统（比如Windows/macOS）安装的，和容器的Linux环境不兼容，或者本地的node_modules里恰好缺少rimraf（比如你之前误删过），就会导致容器里找不到模块。

解决建议 #

针对上面的原因，分别给出解决方案：

方案1：检查并调整rimraf的依赖类型

• 打开你的package.json，查看rimraf所在的位置：
  • 如果它在devDependencies里，但项目运行时确实需要它，把它移到dependencies下，然后重新构建镜像：

    npm install rimraf --save
    docker-compose build node
    

  • 如果不想移动，也可以在Dockerfile里修改npm install命令，安装所有依赖（包括devDependencies）：

    RUN npm install --production=false
    

方案2：添加.dockerignore文件排除不必要的目录

在项目根目录创建.dockerignore文件，内容如下：

node_modules
npm-debug.log
.git
.gitignore

这样可以避免把本地的node_modules、日志文件和Git相关文件复制到容器里，确保容器里的依赖是通过npm install重新安装的，和容器环境兼容。

然后重新构建并启动容器：

docker-compose build node
docker-compose up

额外验证步骤

如果还是有问题，可以进入容器内部检查node_modules里是否有rimraf：

docker exec -it <你的容器名称> bash
cd /usr/src/app
ls node_modules | grep rimraf

如果没有，就重新执行npm install看看有没有报错，排查安装过程中的问题。

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