Jenkins流水线内部节点阶段失败未正确标记的解决方法

这个问题是Scripted Pipeline中嵌套node块时的典型场景——每个node对应独立的执行上下文，内层stage C的失败发生在labelB节点上，不会自动同步到外层stage B的状态（外层stage B的状态基于它所在的labelA节点执行情况），所以才会出现整体构建失败但stage B显示成功的情况。下面给你几个有效的解决方法：

方法1：用catchError捕获并传递错误状态 #

这是最简洁的方式，通过catchError包裹内层node块，明确指定构建结果和阶段结果都设为失败，让外层stage B能正确感知到内层的失败：

node('labelA') {
    stage('stage A') {
        echo "Stage A running on labelA"
    }
    stage('stage B') {
        // 捕获内层所有错误，同时标记当前stage和构建为失败
        catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {
            node('labelB') {
                stage('stage C') {
                    echo "Stage C running on labelB"
                    // 模拟失败场景
                    sh 'exit 1'
                }
            }
        }
    }
}

catchError会拦截块内的所有异常，不仅把整个构建标记为失败，还会将当前的stage B标记为失败，完美解决状态不同步的问题。

方法2：手动捕获错误并传递状态 #

如果你需要更精细的错误控制，可以手动捕获内层的异常，记录失败状态后在外层stage B中主动抛出错误：

node('labelA') {
    stage('stage A') {
        echo "Stage A running on labelA"
    }
    stage('stage B') {
        def stageCFailed = false
        node('labelB') {
            stage('stage C') {
                echo "Stage C running on labelB"
                try {
                    // 模拟失败
                    sh 'exit 1'
                } catch (Exception e) {
                    stageCFailed = true
                    throw e // 先抛出异常确保整体构建失败
                }
            }
        }
        // 外层stage判断内层状态，主动标记失败
        if (stageCFailed) {
            currentBuild.result = 'FAILURE'
            error("Stage C执行失败，标记Stage B为失败")
        }
    }
}

这种方式适合需要在失败后执行额外逻辑的场景，比如清理资源、发送自定义通知等。

方法3：改用Declarative Pipeline（更推荐） #

如果你的流水线可以切换到Declarative风格，它的阶段状态管理更直观，嵌套节点的错误会自动传递给外层阶段：

pipeline {
    agent { label 'labelA' }
    stages {
        stage('stage A') {
            steps {
                echo "Stage A running on labelA"
            }
        }
        stage('stage B') {
            steps {
                script {
                    // 切换到labelB节点执行内层逻辑
                    node('labelB') {
                        stage('stage C') {
                            echo "Stage C running on labelB"
                            sh 'exit 1' // 模拟失败
                        }
                    }
                }
            }
            post {
                failure {
                    echo "Stage B因Stage C失败而标记为失败"
                }
            }
        }
    }
}

Declarative Pipeline会自动将stage B中任何步骤的失败关联到该阶段的状态，不需要额外的捕获逻辑，维护起来更简单。

为什么你之前的尝试没生效？ #

• 你写的currentBuild = 'FAILURE'是错误的语法，正确写法是currentBuild.result = 'FAILURE'，但即使修正了，也只是修改了构建整体状态，无法同步外层阶段的状态，因为外层阶段的上下文在labelA节点，感知不到labelB节点的失败。
• sh 'exit 1'只会让内层stage C失败，但这个失败被限制在labelB的node上下文里，没有传递到外层stage B的执行流程中，所以外层阶段依然显示成功。

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