GitLab CI中如何使用非空的CI_COMMIT_REF_NAME或CI_MERGE_REQUEST_SOURCE_BRANCH_NAME作为镜像标签？

你的核心需求是优先使用MR源分支名作为镜像标签，无MR时使用当前分支名，原语法逻辑没问题，但可能因变量解析歧义导致标签为空，以下是两种可靠的实现方式：

方式1：直接修正参数扩展（简洁写法） #

给 fallback 变量加上大括号包裹，避免Shell解析时的歧义，尤其是当分支名包含斜杠、下划线等特殊字符时：

image: "registry/group/project:${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:-${CI_COMMIT_REF_NAME}}"

方式2：提前定义变量（可读性更强） #

在variables块中预先定义镜像标签变量，后续直接引用，适合复杂场景或需要复用标签的情况：

variables:
  IMAGE_TAG: "${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:-${CI_COMMIT_REF_NAME}}"

image: "registry/group/project:$IMAGE_TAG"

排查标签为空的可能原因 #

如果仍出现标签为空的情况，可添加调试步骤确认变量值：

stages:
  - debug

debug_branch_vars:
  stage: debug
  script:
    - echo "MR源分支: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
    - echo "当前分支: $CI_COMMIT_REF_NAME"
    - echo "最终镜像标签: ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:-${CI_COMMIT_REF_NAME}}"

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