使用Docker buildx构建时自动拉取基础镜像致缓存失效问题问询

核心原因 #

当使用buildx进行多平台构建（即通过--platform指定多个架构，比如你用到的linux/amd64,linux/arm64）时，buildx的默认行为会自动启用拉取基础镜像的操作，等价于显式传递了--pull=true。这是因为多平台构建需要确保基础镜像在所有目标平台上的manifest都是最新状态，所以默认会触发拉取，直接导致本地缓存失效，构建从头开始。

而你之前单平台构建时，--pull参数默认是关闭的，因此可以通过手动传递参数控制是否拉取，两者行为不一致才引发了这个问题。

解决方案 #

在build命令中显式添加--pull=false参数，强制关闭自动拉取基础镜像的行为，这样就能正常复用本地缓存：

docker build \
    --builder my-builder \
    --platform=linux/amd64,linux/arm64 \
    --pull=false \
    --push \
    --tag my-tag \
    --file path/to/Dockerfile \
    .

补充说明 #

• 如果需要更新基础镜像（比如要使用最新版本的ubuntu:22.04），可以临时去掉--pull=false或者显式传递--pull=true，完成更新后再改回--pull=false以保留缓存。
• 该行为是buildx针对多平台构建的特殊逻辑，虽然文档标注--pull参数仍受支持，但多平台场景下的默认值和单平台构建不同，容易被忽略。

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