Spring Boot升级后JAXB依赖仍报NoClassDefFoundError问题求助

问题描述 #

将Spring Boot从2.1.9（JDK 8）升级至2.7.16（JDK 17）后，项目持续报错：

java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException

已尝试在build.gradle中添加JAXB依赖：

implementation group: 'javax.xml.bind', name: 'jaxb-api', version: '2.2.4'
implementation group: 'org.glassfish.jaxb', name: 'jaxb-runtime', version: '4.0.3'

但编译失败，Gradle在compileJava任务中排除了以下JAR包：

Excluding [javax.activation:javax.activation-api, com.zaxxer:HikariCP-java7, ognl:ognl, org.javassist:javassist, com.mchange:c3p0, org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec, javax.persistence:javax.persistence-api]

核心原因分析 #

• JAXB依赖版本不兼容：jaxb-api:2.2.4基于javax.xml.bind旧包，而jaxb-runtime:4.0.3是Jakarta EE 9+版本，使用jakarta.xml.bind新包，两者包名完全不同，无法匹配导致找不到实现类。
• JDK 17的API移除：JDK 9及以上移除了JAXB相关Java EE模块，必须显式引入完整实现，但版本必须统一，不能混合javax和jakarta包的依赖。
• 旧版本依赖冲突：项目中大量旧依赖（如spring-data-redis:2.1.8.RELEASE、springfox-swagger2:2.9.2）与Spring Boot 2.7.16不兼容，会间接影响JAXB类加载，甚至触发Gradle依赖排除机制。
• 重复依赖声明：比如mysql-connector-java同时在runtimeOnly和implementation中声明，javax.activation旧版本依赖也会和JAXB依赖冲突。

解决方案 #

1. 修正JAXB依赖，统一版本 #

移除现有不兼容的JAXB依赖，替换为以下两种方案之一：

方案一：使用Spring Boot JAXB Starter（推荐）

Spring Boot 2.7提供专门starter管理JAXB依赖，自动处理版本兼容：

implementation 'org.springframework.boot:spring-boot-starter-jaxb'

方案二：手动指定兼容的javax版本依赖

确保API和运行时版本一致且基于javax包：

implementation group: 'javax.xml.bind', name: 'jaxb-api', version: '2.3.1'
implementation group: 'org.glassfish.jaxb', name: 'jaxb-runtime', version: '2.3.8'
implementation group: 'org.glassfish.jaxb', name: 'jaxb-core', version: '2.3.8'
implementation group: 'javax.activation', name: 'javax.activation-api', version: '1.2.0'

2. 移除/替换不兼容的旧依赖 #

• 替换SpringFox：springfox-swagger2:2.9.2不支持JDK 17，换成springdoc-openapi：

  // 移除原有springfox依赖
  // implementation group: 'io.springfox', name: 'springfox-swagger-ui', version: '2.9.2'
  // implementation group: 'io.springfox', name: 'springfox-swagger2', version: '2.9.2'
  
  // 添加springdoc依赖
  implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:1.6.14'
  

• 统一Spring生态依赖版本：移除所有手动指定版本的Spring相关依赖，由Spring Boot的dependency-management自动管理：

  // 移除以下手动指定版本的依赖
  // implementation group: 'org.springframework.data', name: 'spring-data-redis', version: '2.1.8.RELEASE'
  // implementation group: 'org.springframework', name: 'spring-test', version: '5.3.8'
  
  // 替换为无版本声明的依赖
  implementation 'org.springframework.boot:spring-boot-starter-data-redis'
  testImplementation 'org.springframework.boot:spring-boot-starter-test'
  

3. 清理重复依赖 #

移除重复的mysql-connector-java声明，保留runtimeOnly即可：

// 移除implementation中的mysql依赖
// implementation group: 'mysql', name: 'mysql-connector-java', version: '8.0.17'

runtimeOnly 'mysql:mysql-connector-java'

4. 强制引入被排除的依赖 #

如果Gradle自动排除了javax.activation-api，显式强制引入：

configurations.all {
    resolutionStrategy.force 'javax.activation:javax.activation-api:1.2.0'
}

验证步骤 #

1. 执行./gradlew clean build清理并重新编译项目
2. 启动项目，检查是否还存在JAXBException类找不到的错误
3. 若仍有问题，执行./gradlew dependencies查看依赖树，排查是否还有冲突的JAXB或javax/activation依赖

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