如何通过EnvInject插件在构建前注入当前GitLab分支至VERSION参数？

我之前也踩过这个一模一样的坑！Jenkins在参数初始化的极早期阶段，确实会优先复用上次构建的参数缓存，而GitLab插件传递的gitlabBranch变量这时候还没完全加载进来，导致你的VERSION参数总是拿到旧值。给你几个亲测有效的解决方案：

方案1：用Groovy脚本直接读取GitLab触发原因（最可靠） #

不管是自由风格还是Pipeline项目，都可以通过GitLab插件的触发原因对象直接获取原始分支信息，完全绕开环境变量加载延迟的问题：

自由风格项目（配合EnvInject） #

1. 在项目配置中，添加**"Prepare an environment for the run"**类型的EnvInject步骤（一定要是这个类型，它是构建启动时最早执行的步骤之一）
2. 选择**"Evaluated Groovy script"**，输入以下脚本：

// 获取GitLab推送触发的原因对象
def gitlabCause = build.getCause(hudson.plugins.gitlab.GitLabPushCause.class)
// 如果是GitLab触发的，就拿对应的分支；否则用默认值origin/master
def targetBranch = gitlabCause ? gitlabCause.getBranch() : "origin/master"
// 返回要注入的环境变量，会覆盖参数化构建中的VERSION值
return [VERSION: targetBranch]

3. 把参数化构建中VERSION的默认值设为origin/master即可，脚本会在极早期覆盖它

Pipeline项目 #

直接在Pipeline最开头的初始化阶段设置VERSION：

pipeline {
    agent any
    parameters {
        string(name: 'VERSION', defaultValue: 'origin/master', description: 'Branch/tag to build')
    }
    stages {
        stage('Initialize Version') {
            steps {
                script {
                    def gitlabCause = currentBuild.getCause(hudson.plugins.gitlab.GitLabPushCause)
                    // 如果是GitLab hook触发，就用实际分支覆盖参数值
                    if (gitlabCause) {
                        env.VERSION = gitlabCause.getBranch()
                        echo "Set VERSION to GitLab branch: ${env.VERSION}"
                    } else {
                        echo "Using manual parameter VERSION: ${params.VERSION}"
                        env.VERSION = params.VERSION
                    }
                }
            }
        }
        // 后续构建阶段直接使用env.VERSION即可
        stage('Build') {
            steps {
                sh "echo Building branch: ${env.VERSION}"
            }
        }
    }
}

方案2：通过Shell脚本生成属性文件（适合自由风格） #

如果不想用Groovy，也可以用Shell脚本直接捕获GitLab变量并生成属性文件，再用EnvInject加载：

1. 在构建步骤最顶端添加**"Execute shell"**步骤，输入：

# 直接读取GitLab插件传递的gitlabBranch变量，不存在则用默认值
TARGET_BRANCH="${gitlabBranch:-origin/master}"
# 写入属性文件
echo "VERSION=${TARGET_BRANCH}" > version.properties

2. 紧接着添加**"Inject environment variables to the build process"步骤，选择"Properties File Path"**，填入version.properties
3. 确保这两个步骤在所有需要用到VERSION的操作（比如SCM拉取、编译）之前执行

关键注意事项 #

• 彻底放弃参数默认值里的${gitlabBranch ?: 'origin/master'}：这是问题的核心！参数初始化阶段Jenkins还没拿到当前的gitlabBranch，只会读取上次构建的缓存值，所以参数默认值必须设为固定的origin/master，再通过脚本覆盖
• 更新GitLab插件到最新版本：旧版本的GitLab插件存在变量传递延迟的Bug，更新后能减少很多奇怪的问题
• 确保EnvInject步骤的执行时机：一定要在SCM拉取之前执行，这样后续步骤才能拿到正确的VERSION值

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