Jenkins Pipeline报错：无法在null对象上调用stage()方法

问题描述 #

我编写了如下Jenkins Pipeline脚本：

node('linux'){
    stage('Setup'){
        echo "Build Stage"
    }
    stage('Build'){
        echo "Build Stage"
    }
    stage('Test'){
        echo "Test Stage"
    }
}

该脚本的Setup阶段可正常运行，但执行后续阶段时抛出异常，报错信息为：

java.lang.NullPointerException: Cannot invoke method stage() on null object
at org.codehaus.groovy.runtime.NullObject.invokeMethod(NullObject.java:91)
at org.codehaus.groovy.runtime.callsite.PogoMetaClassSite.call(PogoMetaClassSite.java:48)
at org.codehaus.groovy.runtime.ca...

请问该如何解决此问题？

回答 #

我之前处理过好几次这类问题，本质原因是脚本式Pipeline中多个stage共享单个node块时，Jenkins的Groovy上下文被意外置空——当执行完第一个stage后，后续调用stage()方法时找不到有效的Pipeline上下文对象，就会抛出这个空指针异常。

这里有两种可靠的修复方案，你可以根据场景选择：

方案1：给每个stage单独绑定node块 #

把每个阶段的逻辑独立放在node块内，避免多个阶段共享同一个节点上下文，这样能彻底规避上下文丢失的问题：

stage('Setup'){
    node('linux'){
        echo "Setup Stage"  // 这里建议改成对应阶段的描述，避免日志混淆
    }
}
stage('Build'){
    node('linux'){
        echo "Build Stage"
    }
}
stage('Test'){
    node('linux'){
        echo "Test Stage"
    }
}

方案2：切换为声明式Pipeline（强烈推荐） #

声明式Pipeline是Jenkins官方主推的写法，结构更规范，上下文管理更稳定，几乎不会出现这类奇怪的上下文bug。改写后的脚本如下：

pipeline {
    agent { node { label 'linux' } }  // 指定所有阶段在linux节点上执行
    stages {
        stage('Setup') {
            steps {
                echo "Setup Stage"
            }
        }
        stage('Build') {
            steps {
                echo "Build Stage"
            }
        }
        stage('Test') {
            steps {
                echo "Test Stage"
            }
        }
    }
}

额外小提示 #

1. 如果你一定要用脚本式Pipeline，建议把Jenkins和Pipeline Stage Step插件升级到最新版本，旧版本确实存在一些上下文管理的遗留bug。
2. 你的Setup阶段里的echo内容写错成了"Build Stage"，改成"Setup Stage"能让日志更清晰，方便后续排查问题。

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