运行docker-compose up报错‘无镜像或构建上下文’的原因排查

问题场景 #

你的微服务项目结构如下：

my-service-one/
  - Dockerfile
  - ...
my-service-two/
  - Dockerfile
  - ...
docker-compose.yml

docker-compose.yml 位于项目根目录，配置内容：

version: "3"
services:
  service-one:
    container_name: service-one
    build:
      dockerfile: ./my-service-one/Dockerfile
    ports:
      - "8081:8081"
  
  service-two:
    container_name: service-two
    build:
      dockerfile: ./my-service-two/Dockerfile
    ports:
      - "8082:8082"

在根目录执行 docker-compose up -d 时出现错误：

$ docker-compose up -d
ERROR: The Compose file is invalid because:
Service service-one has neither an image nor a build context specified. At least one must be provided.

原因分析 #

Docker Compose 的 build 配置中，dockerfile 字段是**相对于构建上下文（context）**的路径，不能单独使用。你只指定了 Dockerfile 的路径，但没有明确告知 Compose 构建时的基准目录（即上下文），所以会触发这个错误。

构建上下文是 Docker 执行构建时的工作目录，所有 COPY、ADD 等指令都是基于这个目录来查找文件的，必须明确指定。

解决方案 #

有两种正确的配置方式：

方式一：明确指定 context 和 dockerfile #

将 context 设为服务所在目录，dockerfile 设为该目录下的文件名（路径相对于 context）：

version: "3"
services:
  service-one:
    container_name: service-one
    build:
      context: ./my-service-one
      dockerfile: Dockerfile
    ports:
      - "8081:8081"
  
  service-two:
    container_name: service-two
    build:
      context: ./my-service-two
      dockerfile: Dockerfile
    ports:
      - "8082:8082"

方式二：使用短格式配置 #

如果 Dockerfile 就在服务目录的根下，可以直接将 build 设为服务目录路径，Compose 会自动查找该目录下的 Dockerfile：

version: "3"
services:
  service-one:
    container_name: service-one
    build: ./my-service-one
    ports:
      - "8081:8081"
  
  service-two:
    container_name: service-two
    build: ./my-service-two
    ports:
      - "8082:8082"

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