Node项目Docker化执行docker-compose up报错：找不到/package.json

执行docker-compose up时遇到错误：

failed to solve: failed to compute cache key: "/package.json" not found

项目目录结构 #

• docker
  • node
    • Dockerfile
• node_modules
• public
• src
• package.json
• package-lock.json
• docker-compose.yaml
• 其他文件

当前配置文件 #

docker-compose.yaml #

version: "3"
services:
  node:
    build: docker/node
    volumes:
      - ./:/app
    ports:
      - 5000:3000

Dockerfile #

FROM node:19-alpine

WORKDIR /app

COPY package.json ./

RUN npm install
COPY . .

EXPOSE 3000

CMD ["npm","start"]

问题原因 #

核心问题是构建上下文路径错误：你的Dockerfile放在docker/node目录下，当docker-compose执行build: docker/node时，会把docker/node作为构建的根上下文，而package.json在项目根目录，不在这个上下文范围内，所以COPY package.json ./会找不到文件。

解决方案 #

方法一：修改docker-compose的构建上下文（推荐） #

将构建上下文指定为项目根目录，同时明确Dockerfile的路径，这样Docker就能访问到根目录下的package.json：

修改后的docker-compose.yaml：

version: "3"
services:
  node:
    build:
      context: .  # 构建上下文设为项目根目录
      dockerfile: docker/node/Dockerfile  # 指定Dockerfile的相对路径
    volumes:
      - ./:/app
      - /app/node_modules  # 避免本地node_modules覆盖容器内的依赖
    ports:
      - 5000:3000

方法二：调整Dockerfile中的COPY路径（不推荐） #

如果不想修改docker-compose，可以调整COPY命令的路径，写成相对于docker/node的相对路径，但这种方式对目录结构变动敏感，容易出错：

修改后的Dockerfile片段：

# 从项目根目录复制package.json，../../对应从docker/node回到根目录
COPY ../../package.json ./
COPY ../../package-lock.json ./

额外优化建议 #

• 先复制package.json和package-lock.json再执行npm install，可以利用Docker的分层缓存，当依赖没有变化时，不需要重新安装依赖，加快构建速度。
• 配置/app/node_modules的匿名卷，避免本地的node_modules覆盖容器内安装的依赖，防止出现依赖版本不兼容的问题。

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