Jenkins流水线无法获取GIT_COMMIT环境变量及Groovy编译报错求助

问题分析 #

1. 编译错误原因：你使用的是声明式流水线，steps块内仅允许执行Jenkins官方步骤（如checkout、bat），直接编写Groovy变量定义（def scmVars = ...）违反语法规则，必须用script块包裹自定义Groovy逻辑。
2. GIT_COMMIT未自动生成：手动调用GitSCM类执行检出时，不会自动将提交哈希注入环境变量，需要主动接收checkout步骤的返回值（包含Git相关变量的Map对象），再手动赋值给环境变量。

修正后的完整流水线脚本 #

pipeline{
    agent {label 'master'}
    stages{
        stage('checkout from SCM'){
            steps{
                script {
                    // 执行Git检出并接收返回的Git变量集合
                    def scmVars = checkout([$class: 'GitSCM', 
                        branches: [[name: '*/${GIT_BRANCH}']], 
                        doGenerateSubmoduleConfigurations: false, 
                        extensions: [], 
                        submoduleCfg: [], 
                        userRemoteConfigs: [[credentialsId: '9595efef-aa11-3366-5e5e-12a11b21da6a', 
                        url: 'https://host:port/xxx/yyy']]])
                    // 将提交哈希赋值给环境变量
                    env.GIT_COMMIT = scmVars.GIT_COMMIT
                }
                bat """
                    echo %GIT_COMMIT%
                    echo ${env.GIT_COMMIT}
                    git rev-parse HEAD
                """
            }         
        }
    }
}

关键说明 #

• script块的作用：在声明式流水线中，script块是Groovy代码的“容器”，允许你在steps内执行自定义变量定义、逻辑判断等Groovy操作。
• scmVars的可用变量：除了GIT_COMMIT，返回的Map还包含GIT_BRANCH、GIT_URL等常用Git相关变量，可根据需求直接使用。
• 环境变量的使用：赋值后的env.GIT_COMMIT在整个流水线生命周期内有效，Windows批处理中用%GIT_COMMIT%引用，Groovy代码中用${env.GIT_COMMIT}引用。

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