如何在Jenkins多分支项目中从环境变量获取真实分支名？

问题描述 #

我正在开发一个Jenkins多分支项目，存在两种构建场景：

• 构建分支时，BRANCH_NAME和GIT_BRANCH会被设为分支名（如master），CHANGE_BRANCH不存在；
• 构建变更请求时，CHANGE_BRANCH设为实际分支名（如feature），BRANCH_NAME和GIT_BRANCH则为变更请求名（如PR-01）。

相关环境变量说明：

• BRANCH_NAME：多分支项目中当前构建的分支名；若为变更请求，名称通常为自定义值。
• GIT_BRANCH：远程分支名（如有）。
• CHANGE_BRANCH：变更请求场景下，对应源码控制系统中实际的分支名，与BRANCH_NAME可能不同。

目前我通过bash参数扩展实现获取真实分支名：sh 'echo branch name: ${CHANGE_BRANCH:-${BRANCH_NAME}}'，请问是否有更Jenkins原生的实现方式？

解决方案 #

有几种Jenkins原生的实现方式，完全不需要依赖shell脚本，推荐程度从高到低排列：

1. 纯Groovy三元运算符实现（最推荐）

直接在声明式流水线的script块里用Groovy的?: Elvis运算符处理，逻辑和你用shell参数扩展完全一致，但更贴合Jenkins原生环境：

pipeline {
    agent any
    stages {
        stage('Fetch Real Branch') {
            steps {
                script {
                    def realBranch = env.CHANGE_BRANCH ?: env.BRANCH_NAME
                    echo "Real branch name: ${realBranch}"
                }
            }
        }
    }
}

Groovy的?:会自动判断左边的env.CHANGE_BRANCH是否为null或空字符串，满足条件就取右边的env.BRANCH_NAME，完美适配你的两种构建场景。

2. 利用分支源插件内置变量（按需使用）

如果你用的是GitHub Branch Source这类主流分支源插件，部分版本会提供GIT_LOCAL_BRANCH变量——这个变量在分支构建和PR构建时都会指向实际的分支名。可以作为补充判断：

script {
    def realBranch = env.GIT_LOCAL_BRANCH ?: env.CHANGE_BRANCH ?: env.BRANCH_NAME
    echo "Real branch name: ${realBranch}"
}

注意：这个变量的可用性取决于插件版本，需要先在你的Jenkins环境里验证是否存在。

3. Pipeline Utility Steps插件扩展（复杂场景用）

如果你的流水线需要处理更复杂的环境变量逻辑，可以安装Pipeline Utility Steps插件，用readEnvironment方法读取并处理，但对于你的需求来说，前两种方式已经足够简洁，这个属于进阶选项。

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