加载同一Jenkins共享库两个版本出现类重复定义错误如何解决

问题规避方案 #

方案1：修改其中一个版本的类全限定名 #

类加载冲突的核心是两个库的类拥有完全相同的全限定名org.jenkinslib.HelperFunctions，只要修改其中一个版本的包路径即可解决：

• 调整旧版本库中HelperFunctions.groovy的包声明为package org.jenkinslib.old，同时调整对应的文件路径为src/org/jenkinslib/old/HelperFunctions.groovy
• 实例化时直接区分调用即可：

def hf = latestlib.org.jenkinslib.HelperFunctions.new()
def hf2 = olderlib.org.jenkinslib.old.HelperFunctions.new()

方案2：通过库的vars全局脚本封装类实例，避免直接引用类全限定名 #

Jenkins共享库的vars目录下的脚本是和对应库实例绑定的，不会触发跨库的类名冲突，你可以在两个版本的库中都新增一个vars/getHelper.groovy文件，内容如下：

def call() {
    return org.jenkinslib.HelperFunctions.new()
}

之后在流水线中不需要直接引用类路径，直接通过库实例调用封装方法即可：

def hf = latestlib.getHelper()
def hf2 = olderlib.getHelper()

该方案不需要修改原有类的包路径，适配成本更低。

方案3：隔离不同版本的执行上下文 #

如果不想修改共享库的代码，可以将需要使用旧版本库的逻辑拆分到独立的执行上下文：

• 将旧版本逻辑封装为独立的Jenkins任务，该任务自行加载旧版本共享库
• 主流水线加载最新版本库完成前置/后置逻辑，中间阶段通过build job: '旧版本任务名', parameters: [...]调用独立任务执行，实现类加载环境完全隔离。

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