Docker Compose不构建自定义镜像却尝试从Docker Hub拉取报错求助

问题根因 #

该报错是Docker Desktop升级后默认启用的Docker Compose V2调整了默认行为导致的：

• 旧版Docker Compose V1会自动识别多服务共用的镜像，若某一个服务配置了该镜像的build规则，会先完成构建再启动所有服务，不会尝试拉取该自定义镜像
• 新版Docker Compose V2默认优先尝试拉取所有服务指定的镜像，拉不到本地不存在的自定义镜像webapp时就直接抛出权限错误，不会自动触发关联服务的构建流程

你的原配置、Dockerfile本身没有逻辑错误，属于版本迭代带来的默认行为变更。

可用解决方案 #

方案1：启动时添加--build参数（最简便） #

执行启动命令时加上构建参数，Compose会先完成所有带build配置的服务的构建，再启动服务：

docker compose up --build

方案2：调整配置显式声明镜像构建规则 #

如果不想每次启动都加参数，可以给所有共用webapp镜像的服务都声明相同的build配置，用YAML锚点可以避免重复编写代码：

version: '3.9'
# 定义公共构建配置锚点
x-common-webapp-build: &common-webapp-build
  build: .
  image: webapp

services:
  frontend:
    <<: *common-webapp-build
    volumes:
      - .:/app
    working_dir: /app/src/frontend
    command: yarn run serve
    ports:
      - 8080:8080
  backend:
    <<: *common-webapp-build
    command: ./run_web.sh
    env_file:
      - .env
    ports:
      - 8081:80
    depends_on:
      - db
  db:
    image: postgres:13
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: user
      POSTGRES_DB: db
      POSTGRES_PASSWORD: XXXXXXXXX

调整后直接执行docker compose up即可正常启动。

方案3：手动预构建镜像 #

和报错提示的操作一致，先单独构建frontend服务生成webapp镜像，再正常启动服务：

docker compose build frontend
docker compose up

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