如何配置GitLab在合并请求CI流程中拉取MR分支而非提交哈希？

GitLab CI 针对merge_requests触发场景有默认的检出逻辑：MR流水线默认检出源分支与目标分支临时合并生成的预合并提交，工作区处于detached HEAD状态，不会自动关联拉取MR对应的专属源工作分支，这就是你遇到gitver无法正确识别分支名的核心原因。

不需要修改平台全局设置，仅通过现有流水线脚本的逻辑调整，即可实现MR流水线执行时拉取对应关联工作分支的效果：

• 直接调用GitLab MR流水线自动注入的内置环境变量定位源分支：
  • CI_MERGE_REQUEST_SOURCE_BRANCH_NAME：存储当前MR关联的源工作分支完整名称
  • CI_MERGE_REQUEST_SOURCE_BRANCH_SHA：存储MR源分支对应的最新提交哈希
• 在现有流水线任务的脚本最前置位置，增加MR场景下的分支切换逻辑：仅当流水线属于MR触发类型时，拉取对应源分支引用并切换到该分支，非MR场景（比如master分支直接触发的流水线）保持原有默认检出逻辑不变。
  调整后的完整配置如下：

# build artifacts and run tests
build-and-test:
  stage: build
  script:
    # MR流水线专属分支拉取逻辑
    - |
      if [ -n "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME" ]; then
        git fetch origin "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
        git checkout "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
      fi
    - mvn $MAVEN_CLI_OPTS clean verify
  only:
    - master
    - merge_requests

• MR触发的流水线会在执行测试命令前，主动拉取当前MR关联的专属工作分支到本地工作区，不再停留在预合并的detached HEAD状态
• gitver这类依赖本地分支名计算版本的工具，可以正常读取真实的工作分支名称，版本识别逻辑不会出现异常
• master分支触发的普通流水线逻辑不受影响，整体流水线执行耗时相比原有配置没有明显增加

内容的提问来源于stack exchange，提问作者Roberto Morávia