如何在Jenkins pipeline.groovy脚本中导入其他Groovy文件？

• 错误1：Jenkins流水线的load方法执行Groovy脚本后，默认返回脚本对象实例，你的两个脚本仅定义了类，没有实例化类并返回，导致load拿到的对象不包含你要的属性/方法
• 错误2：@Field是Groovy中用于标记脚本级变量的注解，不能用在类的成员属性上，此处属于误用
• 错误3：Functions类内部直接引用globals变量，没有将加载后的Globals实例注入到Functions实例中，类作用域无法访问外部脚本的变量
• 错误4：Jenkins流水线中打印日志需要用echo方法，原生println不会输出到流水线任务日志中
• 错误5：你定义的runTests方法缺少方法括号，存在语法错误

1. Globals.groovy #

import groovy.transform.CompileStatic

@CompileStatic
class Globals {
    final String test1 = 'first test'
    final String test2 = 'second test'
}
// 必须实例化后返回，load才能拿到可用的Globals实例
return new Globals()

2. Functions.groovy #

import groovy.transform.CompileStatic

@CompileStatic
class Functions {
    // 定义成员变量接收注入的Globals实例
    private final Globals globals

    // 构造函数注入Globals实例
    Functions(Globals globals) {
        this.globals = globals
    }

    def TestMessage1() {
        echo globals.test1
    }

    def TestMessage2() {
        echo globals.test2
    }
}

// 接收外部传入的Globals实例，实例化Functions后返回
return { Globals globals ->
    return new Functions(globals)
}

3. 流水线脚本（deploy.pipeline.groovy/test.pipeline.groovy通用） #

// 先加载Globals实例
def globals = load('Globals.groovy')
// 加载Functions的构造闭包，传入globals实例拿到可用的Functions对象
def functions = load('Functions.groovy')(globals)

def runTests() {
    stage('Test') {
        functions.TestMessage1()
        functions.TestMessage2()
    }
}

// 执行测试阶段
runTests()

• 所有Groovy脚本必须已经拉取到流水线当前的工作目录中，否则load会找不到文件报错
• 后续扩展方法优先通过构造函数注入依赖，不要在Functions内部直接load Globals，避免循环依赖和实例重复创建
• 如果你的团队使用Jenkins共享库，更推荐将这些类放到共享库的src目录下按包名导入，比load方式更易维护

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