Spring Boot 3.3.3中javax.xml.bind注解缺失及Jakarta适配问题

为什么会出现这个问题？ #

Spring Boot 3.x确实已全面迁移到Jakarta EE规范，不再依赖javax包，但你遇到的情况通常由以下原因导致：

1. 依赖冲突：项目中某个第三方依赖或遗留依赖仍在引入javax.xml.bind相关包，导致类加载时优先加载旧的javax类，而非Jakarta版本。
2. 手动依赖配置不全：直接添加jakarta.xml.bind-api和jaxb-runtime可能缺少Spring Boot自动配置所需的绑定逻辑，或版本与Spring Boot的依赖管理不兼容。
3. 代码残留旧注解：业务代码或实体类中仍在使用javax.xml.bind.annotation.XmlElement而非Jakarta版本的注解，触发了对旧包的依赖。

基于Jakarta依赖的解决步骤 #

1. 替换为Spring Boot官方JAXB Starter #

Spring Boot 3.x提供了封装好的spring-boot-starter-jaxb，会自动引入兼容版本的Jakarta JAXB依赖，无需手动管理jakarta.xml.bind-api和jaxb-runtime：

• Maven：在pom.xml中添加

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jaxb</artifactId>
</dependency>

• Gradle：在build.gradle中添加

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

2. 排查并排除依赖冲突 #

执行依赖分析命令，找出引入javax.xml.bind:jaxb-api的依赖并排除：

• Maven：运行mvn dependency:tree，搜索包含javax.xml.bind的依赖项，然后在对应依赖中添加排除：

<dependency>
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <exclusions>
        <exclusion>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle：运行./gradlew dependencies，找到相关依赖后添加排除：

implementation('xxx:xxx') {
    exclude group: 'javax.xml.bind', module: 'jaxb-api'
}

3. 替换代码中的旧注解 #

全局搜索项目中的javax.xml.bind.annotation，将所有相关注解替换为jakarta.xml.bind.annotation下的对应类，比如：

• 将import javax.xml.bind.annotation.XmlElement;改为import jakarta.xml.bind.annotation.XmlElement;

4. 清理缓存并重新构建 #

清理本地依赖缓存，避免旧版本依赖残留：

• Maven：mvn clean install -U
• Gradle：./gradlew clean build --refresh-dependencies

关于HibernateJpaConfiguration的疑问 #

Spring Boot 3.x的HibernateJpaConfiguration已完全迁移到Jakarta规范，你看到的javax包引用大概率是依赖冲突导致旧版本类被加载。通过上述步骤解决依赖冲突后，该类会加载正确的Jakarta版本实现。

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