Jenkins 升级至 2.361.3 后，Maven 项目因 Java 版本不兼容（UnsupportedClassVersionError）而无法运行，根本原因是新版 Jenkins 强制要求 Java 11 运行时，而旧版 Maven 项目类型依赖 Jenkins 主进程的 JVM，无法隔离使用 JDK 8。

jenkins 升级至 2.361.3 后，maven 构建失败的根本原因是新版 jenkins 强制要求 java 11 运行时，而旧版 maven 项目类型依赖 jenkins 主进程的 jvm，无法隔离使用 jdk 8。

Jenkins 自 2.357 LTS 版本起正式将最低运行环境升级为 Java 11（对应字节码版本 55.0），而你遇到的错误：

Exception in thread "main" java.lang.UnsupportedClassVersionError: 
hudson/remoting/Launcher has been compiled by a more recent version of the Java Runtime (class file version 55.0), 
this version of the Java Runtime only recognizes class file versions up to 52.0

明确表明：Jenkins 主进程（含 remoting 模块）已用 Java 11 编译，但你的 Maven 构建代理或启动环境仍在使用 Java 8（支持最高 class file version 52.0）。值得注意的是，Freestyle 项目仍可运行，是因为它通过 Jenkins 的 JDK Tool 插件（如 Temurin、Oracle JDK 插件）显式指定并隔离了构建所用的 JDK；而传统的 Maven Project 类型（由 maven-plugin 提供）不支持此机制——它直接复用 Jenkins 主 JVM，因此无法绕过 Java 11 强制约束。

Jenkins

通过 REST API 与 Jenkins CI/CD 服务器交互。适用于触发构建、查询状态、查看控制台输出、管理任务或监控 Jenkins...

下载

✅ 正确应对路径（按推荐优先级排序）

1. 迁移至 Pipeline 或 Freestyle 项目（官方唯一支持方案）
   Maven Plugin 官方文档已多年明确标注该类型为 “strongly discouraged”，因其架构僵化、维护停滞、安全风险高。针对 100+ 任务的批量迁移，推荐以下高效方式：

   • 使用 Job DSL Plugin 自动生成 Freestyle 任务：

     // 示例：批量转换 Maven Job 为等效 Freestyle Job
     job('my-maven-job') {
       scm {
         git('https://git.example.com/repo.git')
       }
       steps {
         maven('-B clean package') {
           jdk('jdk-8u362') // 显式指定 JDK 8 工具名（需提前在全局工具配置中定义）
         }
       }
     }

   • 或基于现有 Maven Job 配置 XML 模板，用 Groovy 脚本解析 config.xml 中的 、、SCM 等字段，动态生成 Pipeline Script：

     pipeline {
       agent any
       tools { maven 'maven-3.8.6'; jdk 'jdk-8u362' }
       stages {
         stage('Build') {
           steps {
             sh 'mvn -B clean package'
           }
         }
       }
     }

2. 临时规避（不推荐，仅限短期应急）
   若短期内无法迁移，必须统一 Jenkins 运行环境为 Java 11，并在所有构建节点上安装 Java 11，并确保：

   • Jenkins 主服务以 Java 11 启动（检查 JAVA_HOME 和启动脚本）；
   • 在 Manage Jenkins → Global Tool Configuration 中配置 Java 11 为默认 JDK；
   • 所有 Maven 构建步骤中显式选择该 Java 11 JDK（即使项目本身编译目标为 Java 8）；
   • 在 pom.xml 中严格限定编译兼容性：

     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <version>3.11.0</version>
       <configuration>
         <source>1.8</source>
         <target>1.8</target>
         <release>8</release> <!-- 推荐：启用跨版本编译验证 -->
       </configuration>
     </plugin>

⚠️ 重要提醒：

• maven-toolchains 或 -source/-target 参数无法解决当前错误——该异常发生在 Jenkins 启动 Maven 进程阶段（Launcher 类加载失败），而非 Maven 编译阶段，属于 JVM 运行时层级冲突；
• 继续使用 Maven Project 类型将导致无法获得安全更新、插件兼容性问题及未来 Jenkins 版本彻底移除支持；
• Jenkins 官方升级指南明确指出：LTS 2.361.1 要求 Java 11，无降级或兼容模式。

结论：100+ Maven Job 的迁移看似繁重，实则是技术债清理的必要契机。借助 Job DSL 或脚本化 Pipeline 生成，通常可在数小时内完成全量转换，并显著提升可维护性、可观测性与安全性。拒绝升级 Jenkins 或维持旧项目类型，等于主动暴露于已知漏洞与架构淘汰风险之中。