Docker Compose挂载本地目录失败，Node.js容器启动报错求助

错误根源 #

你遇到的ENOENT错误是因为绑定挂载的特性导致本地空目录覆盖了容器内的文件：
当使用./test:/app这种绑定挂载时，Docker会将本地test-app文件夹下的./test目录直接覆盖容器内的/app目录。由于你本地的./test是空的，容器里通过Dockerfile复制的package.json、index.js以及npm install安装的依赖全部被覆盖，npm start自然找不到必要文件。

另外，你期望的「容器内文件同步到本地」逻辑和绑定挂载的默认行为相反：绑定挂载是本地目录内容覆盖容器目录，而非反向同步。

解决方案 #

要实现「容器内文件同步到本地+双向挂载」，需要先将容器内的文件复制到本地./test目录，再启动挂载：

步骤1：临时启动容器并复制文件 #

1. 用能正常运行的镜像启动临时容器：

   docker run -d --name temp-express express-app:latest
   

2. 将容器内/app的所有文件复制到本地test-app文件夹下的./test目录：

   docker cp temp-express:/app ./test
   

3. 停止并删除临时容器：

   docker stop temp-express && docker rm temp-express
   

步骤2：启动绑定挂载的Compose服务 #

此时本地./test目录已经包含了容器内的所有必要文件，再运行你期望的docker-compose.yml：

version: '3'

services:
  express-app:
    container_name: test
    image: express-app:latest
    ports:
      - 3000:3000
    volumes:
      - ./test:/app

执行docker compose up，容器就能正常启动，且本地./test和容器/app的文件会双向同步。

两种挂载方式的区别 #

• 绑定挂载（./test:/app）：直接映射本地主机目录到容器，本地目录内容会覆盖容器对应目录，适合开发阶段实时同步代码修改，但要求本地目录有必要文件。
• 命名卷（test:/app）：由Docker管理的内部存储卷，第一次启动时会自动将容器内/app的内容复制到卷中，因此能正常运行，但卷内文件不会同步到本地主机目录，仅用于Docker内部持久化。

对比Strapi配置的差异 #

你提供的Strapi配置能正常使用绑定挂载，是因为strapi/strapi镜像启动时会自动初始化项目文件到/srv/app目录。如果本地./app是空的，Strapi会自动生成必要的配置和文件；而你的Express镜像没有这个初始化逻辑，必须确保本地挂载目录已有必要文件才能启动。

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