Tomcat 9 中Jaxb-impl与jaxb-runtime类加载冲突导致类找不到问题

触发根因 #

该问题本质是类加载可见性隔离规则差异导致的类查找失败，并非类文件在部署包中实际缺失：

• Tomcat 7 环境下，Web应用类加载器无强制的JavaEE规范类优先加载逻辑，所有应用内Jar的同包类会被纳入统一类加载路径，跨Jar的类调用可正常完成加载
• Tomcat 9 对Web类加载器做了规则收紧：属于JavaEE规范定义的核心类（如javax.xml.bind包下的接口类），即便未开启委托优先逻辑，也会优先由容器共享类加载器完成加载；应用路径下jaxb-runtime包内的实现类，不会被关联到由容器加载的API类的上下文，当API类需要调用同包下属于jaxb-runtime的实现类时，就会抛出ClassNotFoundException

可行修复路径 #

1. 校准依赖结构，消除同包类重合 #

这是最稳定、无运行时副作用的核心修复方式：

• 首先排查完整依赖树，避免引入同时包含接口和实现的旧版jaxb-api包（早期1.x/2.2及之前版本的jaxb-api没有严格拆分API和实现，会内置和jaxb-runtime完全重合的同包类）
• 严格对齐两个组件的版本号，引入官方拆分后的纯API版本jaxb-api，搭配同版本号的jaxb-runtime，通过依赖排除去掉冗余的嵌套依赖：
  示例Maven依赖配置：

  <!-- 纯API定义包，无实现类 -->
  <dependency>
      <groupId>jakarta.xml.bind</groupId>
      <artifactId>jaxb-api</artifactId>
      <version>2.3.1</version>
  </dependency>
  <!-- 运行时实现包，排除嵌套引入的冲突版本API -->
  <dependency>
      <groupId>org.glassfish.jaxb</groupId>
      <artifactId>jaxb-runtime</artifactId>
      <version>2.3.1</version>
      <exclusions>
          <exclusion>
              <groupId>jakarta.xml.bind</groupId>
              <artifactId>jaxb-api</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 调整后校验依赖结构：同包的RuntimeModelBuilder、Navigator类仅存在于jaxb-runtime包内，jaxb-api包内仅保留必要的接口定义，从根源上消除类重合问题

2. 调整Tomcat9类加载策略，对齐Tomcat7行为 #

适合依赖链路复杂、无法快速调整业务依赖的临时应急场景：

• 修改应用对应的context.xml配置，在Context根标签下添加delegate="false"属性，同时排除JAXB核心包的容器优先加载规则，强制Web应用类加载器优先加载自身路径下的所有类
  示例配置：

  <Context delegate="false" docBase="your-app-path" path="/your-app">
      <!-- 强制跳过容器对JAXB包的优先加载 -->
      <JarScanFilter pluggabilitySkip="jakarta.xml.bind,javax.xml.bind" />
  </Context>
  

• 配置生效后，应用内所有Jar的类会被统一纳入应用类加载路径，类加载逻辑和Tomcat7保持一致，可绕过隔离机制导致的类查找失败问题

3. 清理打包环节的重复类 #

• 排查最终部署包的Jar内容，定位重复打包的同包同名类：多数场景下是打包插件自动合并多Jar内容时，把jaxb-api和jaxb-runtime里的同包类重复输出到同一个Jar中，导致类定义加载顺序错乱
• 移除重复输出的RuntimeModelBuilder.class、Navigator.class文件，保证同包同名类仅在一个Jar包内存在，避免类加载时的签名冲突

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