树莓派执行Docker Compose失败：平台匹配错误排查与修复

配置文件与报错信息 #

docker-compose.yml内容： #

version: '3'

services:
  web:
    platform: linux/arm/v6
    build: ./web
    restart: always
    environment:
      DATABASE_URL: ${DATABASE_URL}
      SECRET_KEY: ${SECRET_KEY}
      TZ: Europe/Amsterdam
    ports:
      - ${PORT}:5000
    depends_on:
      - db
    volumes:
      - web-data:/data
  db:
    platform: linux/arm/v6
    image: arm32v6/postgres:15.1-alpine
    restart: always
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    ports:
      - ${POSTGRES_PORT}:5432
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:
  web-data:

执行报错： #

[+] Building 6.5s (3/3) FINISHED
 => [internal] load build definition from Dockerfile               0.5s
 => => transferring dockerfile: 32B                                0.2s
 => [internal] load .dockerignore                                  0.2s
 => => transferring context: 2B                                    0.1s
 => ERROR resolve image config for docker.io/docker/dockerfile:1   2.4s
------
 > resolve image config for docker.io/docker/dockerfile:1:
------
failed to solve: rpc error: code = Unknown desc = failed to solve with frontend 
dockerfile.v0: failed to solve with frontend gateway.v0: no match for platform in manifest 
sha256:9ba7531bd80fb0a858632727cf7a112fbfd19b17e94c4e84ced81e24ef1a0dbc: not found

错误含义解释 #

no match for platform in manifest表示：Docker在拉取构建流程依赖的docker/dockerfile:1镜像（Docker BuildKit默认使用的构建前端镜像）时，发现该镜像仓库中没有适配linux/arm/v6架构的版本，找不到对应平台的镜像清单条目，因此拉取失败。

修复方法 #

• 方法1：临时禁用BuildKit执行命令
  直接在启动命令前添加环境变量禁用BuildKit，避免拉取不兼容的构建前端镜像：

  DOCKER_BUILDKIT=0 docker compose up -d
  

• 方法2：在docker-compose.yml中永久禁用BuildKit
  在web服务的build配置块中添加buildkit: false，指定该服务构建时不使用BuildKit：

  services:
    web:
      platform: linux/arm/v6
      build:
        context: ./web
        buildkit: false
      # 其他配置保持不变
  

• 方法3：指定兼容arm/v6的构建镜像版本
  如果需要保留BuildKit功能，可以指定仍支持linux/arm/v6架构的Dockerfile构建镜像版本（比如docker/dockerfile:1.4），通过构建参数传递配置：

  services:
    web:
      platform: linux/arm/v6
      build:
        context: ./web
        args:
          BUILDKIT_IMAGE: docker/dockerfile:1.4
      # 其他配置保持不变
  

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