Java 8/JAXB迁移至Java 17/Jakarta：XSD转Java构建报错修复

核心原因 #

Java 17 移除了JDK内置的javax.xml.bind模块，且Jakarta EE规范已将JAXB的包名从javax.xml.bind迁移至jakarta.xml.bind，旧配置仍在查找javax下的类，导致NoClassDefFoundError。

一、更新Gradle任务适配Jakarta #

推荐两种实用方案：

方案1：使用支持Jakarta的第三方Gradle JAXB插件 #

采用org.unbroken-dome.jaxb-plugin（专门适配Jakarta的插件），配置更简洁：

plugins {
    id 'java'
    // 引入适配Jakarta的插件，版本需匹配JAXB版本
    id 'org.unbroken-dome.jaxb' version '4.0.0'
}

// 配置JAXB代码生成规则
jaxb {
    // 指定XSD文件所在目录
    xsdDir = file('src/main/resources')
    // 指定绑定文件路径
    bindings = files('src/main/resources/bindingsv.xjb')
    // 生成代码的目标包名
    packageName = 'com.yourcompany.yourpackage'
    // 指定Jakarta版本的XJC工具版本
    toolVersion = '4.0.1'
    // 可选：关闭自动生成package-info.java
    generatePackageInfo = false
}

// 依赖配置
dependencies {
    // XJC代码生成工具依赖
    jaxb 'org.glassfish.jaxb:jaxb-xjc:4.0.1'
    // Jakarta JAXB API核心依赖
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.1'
    // JAXB运行时实现（GlassFish提供）
    runtimeOnly 'org.glassfish.jaxb:jaxb-runtime:4.0.1'
}

方案2：自定义JavaExec任务 #

若不想引入第三方插件，可手动创建任务调用Jakarta版本的XJC工具：

plugins {
    id 'java'
}

dependencies {
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.1'
    runtimeOnly 'org.glassfish.jaxb:jaxb-runtime:4.0.1'
    // 引入Jakarta版本的XJC代码生成工具
    implementation 'org.glassfish.jaxb:jaxb-xjc:4.0.1'
}

// 自定义生成JAXB实体类的任务
task generateJaxbClasses(type: JavaExec) {
    // 指定XJC工具的主类（Jakarta版本主类未变，但依赖为Jakarta包）
    mainClass = 'com.sun.tools.xjc.XJCFacade'
    // 类路径包含所有JAXB相关依赖
    classpath = sourceSets.main.runtimeClasspath
    // 命令行参数：输出目录、绑定文件、目标XSD文件
    args = [
        '-d', "${projectDir}/src/main/java",
        '-b', "${projectDir}/src/main/resources/bindingsv.xjb",
        "${projectDir}/src/main/resources/your-target-schema.xsd"
    ]
}

// 让编译任务依赖代码生成任务，确保先生成再编译
compileJava.dependsOn(generateJaxbClasses)

二、解决NoClassDefFoundError报错 #

1. 更新绑定文件命名空间
   打开bindingsv.xjb，将原有的javax命名空间替换为Jakarta官方命名空间：

   <!-- 旧的javax命名空间（需删除） -->
   <!-- <jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="2.1"> -->
   
   <!-- 新的Jakarta命名空间 -->
   <jaxb:bindings xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                  jaxb:version="4.0">
   

2. 清理遗留的javax依赖
   执行./gradlew dependencies检查依赖树，若发现遗留的javax.xml.bind:jaxb-api等旧依赖，通过exclude排除：

   dependencies {
       implementation('some-third-party-dependency') {
           exclude group: 'javax.xml.bind', module: 'jaxb-api'
       }
   }
   

3. 验证生成代码的包路径
   运行生成任务后，检查生成的Java类的import语句，确认是import jakarta.xml.bind.*而非import javax.xml.bind.*。若仍是javax路径，需确认jaxb-xjc依赖版本为3.x或4.x（Jakarta版本），而非旧的javax版本。

三、版本匹配说明 #

• Jakarta EE 9 → JAXB版本3.x，适配Java 11+
• Jakarta EE 10 → JAXB版本4.x，适配Java 17+
  建议针对Java 17使用4.x版本的JAXB依赖，兼容性更好。

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