Jenkins任务执行时出现NoClassDefFoundError问题求助

我之前也碰到过类似的Jenkins类加载报错，结合你提到的场景（Maven 2.7.1，已尝试重装workflow-aggregator插件但无效），给你几个实用的排查方向和解决方案：

1. 验证Jenkins核心与插件的版本兼容性 #

这两个报错的类分别关联核心组件和关键插件：

• jenkins.scm.RunWithSCM 属于SCM API插件（或Jenkins核心的SCM模块）
• org.jenkinsci.plugins.workflow.job.WorkflowRun 属于Workflow Job插件
  版本不兼容是这类错误的头号诱因：
• 进入Jenkins的 Manage Jenkins > System Information，记录当前Jenkins核心版本。
• 到 Manage Jenkins > Plugins > Installed Plugins，找到SCM API、Workflow Job、Workflow Aggregator这几个插件，查看它们的版本。
• 对照插件详情页的"Requirements"兼容性说明，如果插件版本过高/过低与Jenkins核心不匹配，要么升级Jenkins核心到符合要求的版本，要么降级插件到适配当前核心的稳定版本。

2. 强制修复插件依赖完整性 #

有时候重装workflow-aggregator时，依赖的插件可能没有被正确安装或更新：

• 先卸载SCM API、Workflow Job和Workflow Aggregator这三个插件（若有依赖提示，按提示处理关联插件）。
• 重启Jenkins服务。
• 重新安装Workflow Aggregator插件，让Jenkins自动处理所有依赖的安装和版本匹配。
• 再次重启Jenkins，确认所有插件都处于激活状态。

3. 清理Jenkins插件缓存解决损坏问题 #

插件缓存文件损坏也会导致类加载失败，即使重装插件也无法修复：

• 停止Jenkins服务。
• 找到Jenkins的插件目录（通常是JENKINS_HOME/plugins，JENKINS_HOME是Jenkins的根目录）。
• 删除以下相关文件和目录：
  • scm-api.jpi 和 scm-api 目录
  • workflow-job.jpi 和 workflow-job 目录
  • workflow-aggregator.jpi 和 workflow-aggregator 目录
• 启动Jenkins，重新安装上述插件。

4. 排查类加载冲突 #

多个插件可能依赖不同版本的同一类，导致类加载混乱：

• 进入Jenkins的 Manage Jenkins > Script Console，执行以下Groovy脚本，查看类的来源：

  // 检查RunWithSCM类的来源JAR
  try {
      def runWithSCMClass = ClassLoader.getSystemClassLoader().loadClass('jenkins.scm.RunWithSCM')
      println "RunWithSCM loaded from: ${runWithSCMClass.getProtectionDomain().getCodeSource().getLocation()}"
  } catch (Exception e) {
      println "Failed to load RunWithSCM: ${e.getMessage()}"
  }
  
  // 检查WorkflowRun类的来源JAR
  try {
      def workflowRunClass = ClassLoader.getSystemClassLoader().loadClass('org.jenkinsci.plugins.workflow.job.WorkflowRun')
      println "WorkflowRun loaded from: ${workflowRunClass.getProtectionDomain().getCodeSource().getLocation()}"
  } catch (Exception e) {
      println "Failed to load WorkflowRun: ${e.getMessage()}"
  }
  

• 如果输出显示多个路径或异常，说明存在类冲突，需要卸载冲突的插件（比如某个旧插件依赖了过时的SCM API版本）。

5. 简化任务配置排查问题 #

有时候任务配置的混合使用（比如传统Maven任务和Pipeline配置冲突）也会触发这类错误：

• 创建一个全新的Maven任务，只保留最基础的配置：指定Git仓库、Maven目标（如clean install）。
• 运行这个新任务，看是否还会报错。如果新任务正常，说明原任务的配置存在问题，需要逐步排查原任务的SCM设置、触发器、预处理步骤等。

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