Docker-Compose挂载node_modules卷报错：目录不存在问题求助

问题原因 #

你在docker-compose.yml中配置了绑定类型的本地卷，将宿主机的../node_modules目录绑定到容器内的/srv/app/node_modules。Docker在处理这种绑定卷时，不会自动创建宿主机上不存在的目标目录。如果宿主机项目根目录下没有提前创建node_modules，挂载操作就会因找不到目录而失败，触发你看到的报错。

解决方法 #

提供三种实用方案，可根据场景选择：

方案1：使用Docker命名卷（推荐，适合开发环境） #

放弃手动绑定宿主机目录，改用Docker自动管理的命名卷。这种方式不需要提前创建宿主机目录，Docker会自动初始化卷，并将镜像中预安装的node_modules同步到卷中，同时能缓存依赖，避免重复安装。

修改docker-compose.yml：

version: "3.4"

services:
  node:
    build:
      context: ..
      dockerfile: ./docker/node/Dockerfile
    container_name: node
    ports:
      - "8000:8000"
    volumes:
      - node_modules:/srv/app/node_modules
      # 开发时如需实时同步项目代码，可添加此行：
      # - ../:/srv/app

volumes:
  node_modules:
    # 移除原driver_opts配置，使用默认local驱动

方案2：启动前自动创建宿主机目录 #

通过添加临时初始化容器，在启动node服务前自动创建宿主机的node_modules目录，避免手动操作：

修改docker-compose.yml：

version: "3.4"

services:
  init:
    image: alpine:latest
    command: mkdir -p /app/node_modules
    volumes:
      - ../:/app
  node:
    build:
      context: ..
      dockerfile: ./docker/node/Dockerfile
    container_name: node
    ports:
      - "8000:8000"
    volumes:
      - node_modules:/srv/app/node_modules
    depends_on:
      - init

volumes:
  node_modules:
    driver: local
    driver_opts:
      type: "none"
      o: "bind"
      device: "../node_modules"

执行docker-compose up时，会先运行init容器创建目录，再启动node服务。

方案3：移除node_modules挂载（适合生产环境） #

如果是生产部署，不需要将node_modules挂载到宿主机。直接利用Dockerfile中RUN npm install构建好的镜像，启动容器时不挂载该卷，彻底避免目录依赖问题：

修改docker-compose.yml：

version: "3.4"

services:
  node:
    build:
      context: ..
      dockerfile: ./docker/node/Dockerfile
    container_name: node
    ports:
      - "8000:8000"
    # 移除node_modules相关的volume配置

# 移除volumes部分的node_modules定义

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