Jenkins Pipeline报错：post块位置错误，如何按条件执行构建后步骤？

报错原因 #

你遇到的“Expected a stage”错误，是因为Jenkins Pipeline的post块不支持直接编写条件判断语句。post的语法要求其下只能是预定义的条件块（如always、success、failure），不能直接嵌套if这类自定义逻辑，否则会触发语法解析错误。

正确实现方式 #

要实现“仅当Execute Test阶段执行过才发布测试结果”的需求，你需要把条件判断逻辑放到post块内的script块中，同时保留全局flag的思路。示例代码如下：

// 全局定义flag，初始为false
def testExecuted = false

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'build-project.sh'
            }
        }
        stage('Execute Test') {
            steps {
                script {
                    // 进入该阶段后将flag设为true
                    testExecuted = true
                    // 执行测试命令
                    sh 'run-tests.sh'
                }
            }
        }
    }
    post {
        // 无论构建结果如何，都进入该块判断
        always {
            script {
                // 根据flag判断是否发布测试结果
                if (testExecuted) {
                    echo "发布测试结果..."
                    sh 'publish-test-results.sh'
                } else {
                    echo "测试阶段未执行，跳过发布操作"
                }
            }
        }
    }
}

关键说明 #

1. 全局变量作用域：testExecuted定义在pipeline代码块外部，确保所有阶段都能访问并修改其值。
2. script块的作用：post块内必须用script包裹自定义逻辑，这是Jenkins Pipeline语法的要求，否则会触发解析错误。
3. always块的选择：使用always能覆盖测试阶段成功/失败的场景，只要测试阶段执行过（testExecuted为true），就会执行发布操作；如果前面阶段失败导致测试阶段被跳过，testExecuted保持false，就会跳过发布。

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