Podman构建异常：误从Docker Hub拉取builder-false镜像求助

1. 检查Dockerfile阶段命名语法 #

确保builder-false阶段的定义无语法错误，多阶段构建的标准格式应为：

# 正确阶段定义示例
FROM alpine AS builder-false
# 阶段内构建步骤
RUN echo "test build" > /tmp/test

FROM alpine
# 引用本地阶段的步骤
COPY --from=builder-false /tmp/test /dest

如果AS关键字拼写错误（比如大小写错误、漏写），Podman会将builder-false识别为远端镜像名，触发拉取逻辑。

2. 验证COPY --from的阶段引用准确性 #

确认后续阶段引用该阶段时，名称完全匹配（包括大小写、连字符）：

• 错误示例：COPY --from=builderfalse /xxx /yyy（缺失连字符）
• 错误示例：COPY --from=Builder-False /xxx /yyy（大小写不匹配）
  Podman对阶段名的匹配是大小写敏感的，拼写不一致会导致系统尝试从远端拉取同名镜像。

3. 强制跳过缓存重新构建 #

缓存可能导致Podman误判阶段已存在，跳过本地构建。执行构建时添加--no-cache参数：

podman build --no-cache . -t prova:latest

4. 检查Podman镜像拉取配置 #

查看Mac上的Podman配置文件~/.config/containers/registries.conf，确认是否存在强制拉取镜像的规则：

• 是否配置unqualified-search-registries包含docker.io，且builder-false刚好匹配公共镜像名
• 是否存在[[registry]]块设置了强制拉取或镜像镜像策略
  可临时注释相关配置后重新测试。

5. 构建最小可复现示例验证 #

将简化版Dockerfile压缩到最基础形式，确认问题是否存在：

FROM alpine AS builder-false
RUN echo "local stage build" > /test.txt

FROM alpine
COPY --from=builder-false /test.txt /
RUN cat /test.txt

执行构建后，若能正常输出local stage build，说明原简化版Dockerfile存在其他语法或逻辑问题。

6. 升级Podman到最新稳定版 #

部分旧版本Podman存在多阶段构建的已知bug（比如特殊字符阶段名识别问题），可通过Homebrew升级：

brew upgrade podman

内容的提问来源于stack exchange，提问作者Salvatore D'angelo