Jenkins Pipeline中when表达式访问环境变量的问题

核心原因 #

when子句的评估时机是阶段开始执行前，如果你的环境变量是在前面阶段的steps里才赋值（尤其是通过shell命令临时设置的），when评估时可能还没拿到最新的变量值；另外，变量引用方式不对也会导致判断失败。

具体解决办法 #

1. 直接通过env对象赋值全局环境变量 #

如果变量是在前面阶段生成的，一定要用script块结合env.变量名赋值，这样变量会被放到Pipeline的全局环境中，when子句能正确读取：

pipeline {
    agent any
    stages {
        stage('Stage3') {
            steps {
                script {
                    // 直接给env对象赋值，全局可见
                    env.os_type = 'win'
                    env.enOS = 'win'
                    echo "os_type: ${env.os_type}, enOS: ${env.enOS}"
                }
            }
        }
        stage('Stage4') {
            // when里用env.变量名引用
            when {
                expression { env.os_type == 'win' }
            }
            steps {
                echo "Stage4执行成功"
            }
        }
    }
}

2. 提前在全局environment块定义变量 #

如果变量值是预先确定的，或者可以在Pipeline开始前初始化，直接在全局environment块里定义，when能直接读取：

pipeline {
    agent any
    environment {
        os_type = 'win'
    }
    stages {
        stage('Stage4') {
            when {
                expression { env.os_type == 'win' }
            }
            steps {
                echo "执行Windows专属步骤"
            }
        }
    }
}

3. 正确捕获命令行输出并赋值 #

如果变量是通过shell/bat命令获取的，要捕获输出并赋值给env，不要用shell的export（只在当前shell会话有效，Pipeline全局拿不到）：

stage('获取系统类型') {
    steps {
        script {
            // Windows下用bat，Linux用sh
            def osResult = bat(returnStdout: true, script: 'echo win').trim()
            env.os_type = osResult
        }
    }
}

避坑提醒 #

• 绝对不要在when里直接写变量名（比如os_type == 'win'），必须用env.os_type，否则会被当成Groovy局部变量，而非Pipeline环境变量。
• 如果用withEnv设置临时变量，只能在当前阶段的steps里生效，when子句在阶段外评估的话拿不到，这种情况建议改用全局env赋值。

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