Jenkinsfile阶段调用Groovy脚本无法访问PostBuild的manager对象

问题原因 #

• 你通过sh "groovy folderName/myScript"执行外部Groovy脚本时，实际启动了一个独立的Groovy进程，该进程完全脱离Jenkins Pipeline的运行上下文。Groovy Postbuild插件的manager对象是Jenkins运行时内存中的上下文对象，独立进程根本无法访问它。
• 尝试通过sh "groovy folderName/myScript ${manager}"传递参数时，实际传递的是manager对象的字符串表示（即toString()方法的返回结果），并非真实的对象引用。因此在脚本里调用createSummary等方法时，本质是对字符串调用这些不存在的方法，自然会报“找不到合适方法签名”的错误。
• 而在Jenkinsfile的阶段里直接调用manager方法可行，是因为这些代码运行在Jenkins Pipeline的上下文环境中，直接持有manager对象的有效引用。

解决方案 #

方案1：将脚本逻辑内联到Jenkinsfile中 #

如果脚本逻辑不复杂，直接把代码写到Jenkinsfile的步骤里，即可直接访问manager对象：

node(NODE) {
    stages {
        stage('first') {
            steps {
                checkout scm
            }
        }
        stage('run logic') {
            steps {
                script {
                    // 这里编写原myScript里的业务逻辑
                    def num = 10 // 示例数值，替换为实际业务计算结果
                    def summary_manager = manager.createSummary("green_anime.gif");
                    manager.addShortText("Blocked: $num");
                    summary_manager.appendText("<h3>Number of Blocked Users: $num</h3>", false);
                }
            }
        }
    }
}

方案2：用Pipeline的load方法加载外部脚本 #

如果必须保留外部Groovy文件，不要用sh执行，而是使用Jenkins Pipeline的load方法——它会将外部脚本加载到当前Pipeline上下文里执行，脚本就能直接访问manager对象：

修改Jenkinsfile

node(NODE) {
    stages {
        stage('first') {
            steps {
                checkout scm
            }
        }
        stage('run myScript') {
            steps {
                script {
                    // 加载外部Groovy脚本，脚本将在当前Pipeline上下文执行
                    load "folderName/myScript.groovy"
                }
            }
        }
    }
}

修改myScript.groovy

不需要类和main方法，直接编写逻辑即可（load会直接执行脚本内容）：

// 初始化变量
def num = 10 // 替换为实际业务计算结果
// 业务逻辑代码
// 直接使用manager对象
def summary_manager = manager.createSummary("green_anime.gif");
manager.addShortText("Blocked: $num");
summary_manager.appendText("<h3>Number of Blocked Users: $num</h3>", false);

如果需要传递参数给外部脚本，可以在脚本中定义方法并返回脚本对象：

// myScript.groovy
def run(def num) {
    def summary_manager = manager.createSummary("green_anime.gif");
    manager.addShortText("Blocked: $num");
    summary_manager.appendText("<h3>Number of Blocked Users: $num</h3>", false);
}

return this // 返回脚本对象，让Pipeline可以调用run方法

对应的Jenkinsfile调用方式：

script {
    def myScript = load "folderName/myScript.groovy"
    def num = 10 // 从业务逻辑中获取的数值
    myScript.run(num)
}

注意事项 #

• 确保Jenkins已安装Groovy Postbuild插件，且插件版本与Jenkins版本兼容。
• manager对象属于Groovy Postbuild插件，在Pipeline中使用时无需额外导入，直接调用即可。

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