迁移至Spring Boot 3遇阻：javax.xml.namespace转jakarta问题求助

核心原因 #

Tomcat 10及以上完全基于Jakarta EE规范，不再支持javax.*命名空间，javax.xml.namespace对应的Jakarta版本是jakarta.xml.namespace，该包已包含在Jakarta EE API中，出现启动问题多是代码/依赖未完成迁移、依赖引入不正确导致。

具体解决步骤 #

• 全局替换代码引用
  把所有Java文件、XML配置里的import javax.xml.namespace.*替换为import jakarta.xml.namespace.*，XML配置中的命名空间声明也要同步更新。

• 确保依赖正确引入
  Spring Boot 3的starter已默认引入多数Jakarta依赖，若有特殊场景，手动补充Jakarta XML API依赖：
  Maven：

  <dependency>
      <groupId>jakarta.xml.bind</groupId>
      <artifactId>jakarta.xml.bind-api</artifactId>
      <version>4.0.0</version>
  </dependency>
  

  Gradle：

  implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.0'
  

• 处理第三方依赖兼容问题
  优先升级第三方库到Jakarta兼容版本（通常版本号会大幅提升，比如从2.x升到4.x）。如果暂时没有兼容版本，可使用字节码转换工具处理：
  在Maven中配置jakarta-maven-plugin自动转换依赖字节码：

  <plugin>
      <groupId>org.eclipse.transformer</groupId>
      <artifactId>jakarta-maven-plugin</artifactId>
      <version>2.0.0</version>
      <executions>
          <execution>
              <id>transform</id>
              <phase>process-resources</phase>
              <goals>
                  <goal>transform</goal>
              </goals>
              <configuration>
                  <!-- 指定需要转换的依赖目录或文件 -->
                  <inputDirectory>${project.build.directory}/tmp</inputDirectory>
                  <outputDirectory>${project.build.directory}/classes</outputDirectory>
              </configuration>
          </execution>
      </executions>
  </plugin>
  

• 验证打包与Tomcat配置
  检查打包后的WAR包，确保没有遗留javax.*的class文件；同时确认Tomcat 10的conf/catalina.properties中未添加兼容javax.*的配置，避免冲突。

临时替代方案 #

如果上述方法无法快速落地，可临时使用Spring Boot内置Tomcat（Spring Boot 3默认适配Tomcat 10），规避外部Tomcat的配置问题；或封装适配层，手动转换javax.xml.namespace与jakarta.xml.namespace的对象，但这只是过渡方案，最终需完成全量迁移。

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