Docker指定平台无对应镜像未报错 如何配置buildx强制构建失败

Buildx 调用的底层 BuildKit 引擎，默认镜像拉取解析策略为prefer：

• 拉取基础镜像时优先匹配--platform参数指定的目标架构
• 若对应镜像tag的manifest列表中不存在目标架构的条目，不会直接报错退出，会自动回退拉取当前构建主机原生架构可用的镜像版本
• 构建产出的镜像元数据里，平台字段会直接标记为你指定的目标架构，不会校验实际拉取的镜像层架构是否和目标平台一致

你碰到的就是这个默认回退逻辑触发的结果：nvidia/cuda:10.1-cudnn7-runtime 确实没有提供arm64架构镜像，BuildKit拉取时找不到匹配项，就自动拉了amd64版本的镜像层完成构建，还把镜像元数据的平台标成了linux/arm64。你在amd64主机上运行时，Docker读元数据发现标记平台和主机平台不一致就弹了警告，但镜像里的二进制全是amd64的，可以直接在主机上原生跑，所以才会出现有警告但命令执行成功、uname输出x86_64信息的情况。

把BuildKit的镜像解析模式从默认的prefer改成strict就行。strict模式会强制要求拉取的基础镜像必须存在对应目标平台的manifest条目，只要找不到匹配项就直接抛错终止构建，不会触发回退，有两种常用配置方式：

• 单次构建临时生效：构建命令里追加builder参数

  docker buildx build -f ./docker/Dockerfile.wtf -t asdf \
    --platform linux/arm64 \
    --load \
    --no-cache \
    --opt image.resolveMode=strict \
    .
  

• 全局永久生效：创建默认启用强校验的buildx构建器，后续所有构建自动应用规则

  docker buildx create --use --name strict-builder \
    --driver-opt image.resolveMode=strict
  docker buildx inspect --bootstrap
  

配置完成后再构建你提供的Dockerfile，会直接抛出“manifest中无对应平台匹配项”的错误，不会再拉取错误架构的镜像完成构建。

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