Jenkins向Nexus发布构件报错：PluginClassLoader问题

以下是针对该问题的常见排查与解决方法：

• 检查Workflow CPS插件兼容性
  即使所有插件已更新至最新版，仍可能存在插件间隐性兼容性冲突。尝试将workflow-cps插件回退至上一个稳定版本（例如当前最新为2.x系列，可回退至1.x的稳定发布版），之后重新运行流水线。操作路径：Jenkins管理页面 → 插件管理 → 已安装插件 → 找到Workflow CPS插件 → 点击「回退」按钮。

• 清理Jenkins插件缓存
  插件缓存损坏可能引发类加载异常，执行以下步骤修复：

  1. 停止Jenkins服务
  2. 删除Jenkins安装目录下的plugins/workflow-cps文件夹，以及cache目录中与该插件相关的缓存文件
  3. 重启Jenkins后重新安装workflow-cps插件

• 排查流水线脚本中的类加载冲突
  若Jenkinsfile中使用了自定义类或第三方依赖，可能与插件类加载器产生冲突。例如：

  • 避免引入与Jenkins核心/插件同名的类
  • 使用@Grab注解时开启类加载器隔离：

    @Grab(group='com.example', module='your-dependency', version='1.0', classLoaderIsolation=true)
    

• 验证Jenkins系统类路径配置
  检查Jenkins全局配置的「全局属性」中是否存在干扰类加载的系统变量，比如JAVA_OPTS中自定义的类路径参数。尝试移除非必要的系统变量后重启Jenkins，再测试流水线。

• 检查Nexus发布逻辑的实现
  若使用nexusArtifactUploader插件或自定义发布脚本，确认发布过程中没有触发类加载异常的操作。建议替换为Jenkins官方推荐的Nexus Platform Plugin，避免自定义脚本中的潜在问题。

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