Bitbucket Cloud Pipeline中Docker build --target参数被忽略求助

• 核对Dockerfile的Stage命名
  确保Dockerfile中定义的stage名称和--target指定的完全一致，Docker对这个名称是大小写敏感的。比如检查是不是写成了FROM node:18 AS Staging但命令里用了--target staging，这种大小写不匹配会导致target被忽略。

• 确认Pipeline使用的Docker版本
  多阶段构建的--target选项要求Docker版本在17.05及以上。在Pipeline的脚本步骤里先执行docker --version查看当前版本，如果版本过低，在bitbucket-pipelines.yml中指定更高版本的Docker镜像，比如：

  image: docker:24
  options:
    docker: true
  

• 检查Pipeline命令的语法正确性
  确保bitbucket-pipelines.yml中的构建命令没有语法错误：

  • 单行命令要完整，比如script: - docker build -t image_name --target staging .
  • 多行命令要正确使用反斜杠换行，反斜杠后不能有多余空格：

    script:
      - docker build \
          -t image_name \
          --target staging \
          .
    

  语法错误会导致命令解析异常，--target参数可能被丢弃。

• 分析构建日志的完整输出
  查看Bitbucket Pipeline的构建日志，确认实际执行的docker build命令是否包含--target staging：

  • 如果日志里命令没有--target，说明yml配置有误；
  • 如果命令包含但仍构建了最终阶段，那问题出在Dockerfile本身，比如staging阶段存在语法错误，或者后续阶段的逻辑覆盖了它。

• 本地复现验证Dockerfile
  在本地环境执行完全相同的docker build -t image_name --target staging .命令，如果本地也无法正确构建指定阶段，说明Dockerfile存在问题：

  • 检查staging阶段的定义是否完整，比如有没有遗漏AS staging；
  • 确认后续阶段没有强制覆盖构建流程，比如是否有条件构建逻辑导致跳过target。

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