NodeJS客户端Docker运行报错ENOENT：找不到/app/package.json求解决方案

问题背景 #

为NodeJS客户端编写的Dockerfile如下：

FROM node:16.15.1-alpine

WORKDIR /app

COPY package*.json .
RUN npm install

COPY . .

EXPOSE 3000

CMD ["npm", "start"]

docker-compose.yml（位于项目根目录）中客户端服务配置：

version: '3'
services:
  client:
    build:
      context: ./client
    stdin_open: true
    image: client:latest
    container_name: react-ui
    ports:
      - "3000:3000"
    volumes:
      - ./client:/app
    depends_on:
      - server

  # 其他服务配置省略...

执行操作步骤：

1. 构建客户端镜像：docker-compose build client
2. 保存镜像为tar包：docker save -o client_image.tar client:latest
3. 在目标环境加载镜像：docker load -i client_image.tar
4. 运行容器：docker-compose up

运行时出现错误：

npm ERR! code ENOENT
npm ERR! syscall open
npm ERR! path /app/package.json
npm ERR! errno -2
npm ERR! enoent ENOENT: no such file or directory, open '/app/package.json'
npm ERR! enoent This is related to npm not being able to find a file.
npm ERR! enoent 
ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2023-12-19T02_18_10_854Z-debug-0.log

注：Docker Desktop文件浏览器中可见客户端镜像的/app目录下存在package.json，但运行容器时仍报错。Dockerfile与客户端package.json位于项目根目录的client文件夹中。

原因分析 #

问题出在docker-compose.yml中client服务的volumes配置：- ./client:/app。

当启动容器时，Docker会将本地项目根目录下的./client目录挂载并覆盖容器内的/app目录。如果加载镜像并运行的目标环境中：

• 不存在./client目录，或者该目录为空
• ./client目录内没有package.json文件

就会导致容器内/app目录下找不到package.json，触发上述错误。

镜像本身是包含完整代码和package.json的，但本地挂载的目录覆盖了镜像内的原有内容，才会出现“镜像里有文件，但容器运行时找不到”的矛盾情况。

解决方法 #

方法一：移除本地目录挂载（推荐生产环境使用） #

如果不需要本地代码热更新（比如生产部署场景），直接删除client服务的volumes配置：

client:
  build:
    context: ./client
  stdin_open: true
  image: client:latest
  container_name: react-ui
  ports:
    - "3000:3000"
  # 移除下面这行挂载配置
  # volumes:
  #   - ./client:/app
  depends_on:
    - server

这样容器会直接使用镜像内预构建好的/app目录内容，不会被本地目录覆盖。

方法二：确保目标环境存在正确的本地client目录 #

如果需要保留挂载（比如开发时热更新），需保证运行docker-compose up的环境中：

• 项目根目录下存在client文件夹
• 该文件夹内包含完整的package.json及其他客户端代码，与构建镜像时的内容一致

方法三：添加node_modules匿名卷（开发场景补充） #

参考server服务的配置，给client服务添加一个匿名卷挂载/app/node_modules，避免本地挂载覆盖镜像中安装好的依赖：

client:
  # 其他配置...
  volumes:
    - ./client:/app
    - /app/node_modules  # 添加这一行，保留镜像内的node_modules

但此方法仍需确保本地client目录存在package.json，否则核心问题依然存在。

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