Jenkins全局共享库加载时自动执行函数的实现问题

问题根源 #

你放在src/org/test/Always.groovy里的代码不会自动执行——Jenkins共享库的src目录属于类路径，只有被流水线脚本主动引用时才会加载实例化，不会在共享库加载阶段自动触发执行。

正确实现方式 #

要让代码在共享库隐式加载时自动运行，得用共享库的vars目录特性，这是官方支持的自动加载入口：

步骤1：调整共享库目录结构 #

在共享库根目录下创建vars文件夹，里面新建一个脚本文件（比如autoRun.groovy，命名无强制要求，符合Groovy规范即可）。

步骤2：编写自动执行脚本 #

vars/autoRun.groovy内容如下：

#!/usr/bin/env groovy

// 顶层代码会在共享库加载时自动执行
println "Always print me"

// 如果需要复用类逻辑，可在这里实例化你的Always类
import org.test.Always
new Always()

步骤3：保留原有类定义 #

src/org/test/Always.groovy保持原有代码不变：

#!/usr/bin/env groovy
package org.test

class Always implements Serializable {
    Always() {
        println "Always print me from class constructor"
    }
}

步骤4：确认Jenkins配置 #

在Jenkins全局配置的「Global Pipeline Libraries」中，确保你的共享库已勾选Load implicitly（隐式加载）选项。

关键注意事项 #

• vars目录下的脚本，顶层代码会在共享库加载时自动执行；如果脚本定义了call()方法，需显式调用，但隐式加载场景下直接写顶层代码更适配需求。
• 所有涉及流水线上下文的代码必须实现Serializable接口，避免Jenkins流水线序列化报错。
• 确保Jenkins服务器有权限访问共享库的代码仓库，拉取最新的库文件。

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