Jenkins单Job多阶段重复加载Groovy脚本报重复类定义错误

报错核心是Jenkins脚本式流水线的CPS Groovy运行时使用全局共享的CleanGroovyClassLoader，你在external.groovy里定义的顶层JobConfig类、以及Groovy为脚本本身自动生成的Script1类，第一次执行load时就会被注册到这个全局类加载器中。
同一个类加载器不允许重复定义全限定名完全一致的类，后续再次调用load时，Groovy会尝试重新注册同名类，直接抛出LinkageError。之前尝试清除currentBuild.rawBuild.getExecution().loadedScripts缓存的方案无效，是因为该缓存仅存储脚本执行的对象引用，无法卸载类加载器中已经写入的类定义。

报错参考截图：

方案1：改造外部脚本，移除顶层具名类（最稳定，优先推荐） #

从根源避免重复类定义，不要在被load的外部脚本中编写顶层class，把类定义挪到方法内部，其余逻辑完全不需要改动，不会影响原有调用方式。
改造后的somepath/external.groovy示例：

// 工厂方法返回配置实例，类定义放在方法内部
def createJobConfig() {
    class JobConfig {
        def someDataVar1
        def someDataVar2
    }
    return new JobConfig()
}

def sayHello() {
    println 'hello'
}

return this

主流水线的调用逻辑不需要做任何调整，每次执行loadScripts拉取最新脚本后，config.sayHello()、config.createJobConfig()都可以正常执行，不会再出现重复类报错。

方案2：动态生成唯一脚本名加载（适用于不方便大幅修改外部脚本的场景） #

如果暂时没法调整外部脚本结构，可以改造loadScripts方法，每次加载时给脚本生成唯一文件名，避免脚本生成的类名重复：

def loadScripts() {
    checkout scm
    // 生成唯一后缀，避免类名冲突
    def uniqueId = UUID.randomUUID().toString().replace("-", "")
    def scriptContent = readFile "somepath/external.groovy"
    // 写入带唯一后缀的临时脚本文件
    writeFile file: "somepath/external_${uniqueId}.groovy", text: scriptContent
    def config = load "somepath/external_${uniqueId}.groovy"
    return config
}

注意：如果外部脚本中存在自定义的顶层具名类（比如示例里的JobConfig），这个方案依然会报重复类错误，必须配合把顶层类移到方法内部使用。

方案3：拆分独立子流水线做阶段隔离（最彻底的隔离方案） #

如果各阶段之间不需要传递复杂的上下文参数，可以把每个需要审批后执行的部署阶段拆成独立的子流水线任务，每次审批通过后触发全新的子流水线运行。子流水线启动时会使用全新的类加载环境，天然不存在重复类问题，同时会自动拉取SCM仓库里的最新脚本，完全匹配需求。
主流水线改造示例：

node('agent') {
    stage('build') {
        def config = loadScripts()
        echo 'perform build tasks'
    }
    stage('deploy-dev') {
        input message: 'approve'
        // 触发独立的dev部署子流水线，全新执行环境自动拉取最新脚本
        build job: 'deploy-dev-job', wait: true
    }
    stage('deploy-sit') {
        input message: 'approve'
        build job: 'deploy-sit-job', wait: true
    }
}

def loadScripts() {
    checkout scm
    config = load 'somepath/external.groovy'
    return config
}

不要尝试通过反射强行清理GroovyClassLoader中已注册的类，Jenkins CPS运行时对类加载、流水线序列化有特殊封装，强行修改会导致流水线执行状态错乱、断点恢复失败等更难排查的问题。

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