Jetty多WAR容器同类别加载器致类型转换异常排查求助

根因分析 #

1. WAR包类加载隔离特性：Jetty默认给每个部署的WAR包分配独立的WebAppClassLoader，每个WAR会优先加载自身WEB-INF/lib目录下的jar包。你的a.war和b.war各自打包了同一版本的x.jar，导致两个WAR分别加载了x.jar中的LogRecord类——尽管类的全限定名完全相同，但由于类加载器不同，JVM会将它们判定为不同的类型，直接触发类型转换异常。
2. 盘符差异的触发逻辑：Windows系统下，C盘作为系统盘，Jetty部署在此路径时，x.jar可能被意外加入了系统classpath或Jetty全局类加载路径（比如误放在${jetty.home}/lib下），此时两个WAR会共用系统类加载器加载的LogRecord实例，因此没有异常；而部署到E盘时，全局类加载路径不包含x.jar，两个WAR只能各自加载私有副本，类加载隔离的问题就暴露出来了。

解决办法 #

• 全局共享jar包：将x.jar移动到Jetty的全局扩展类库目录（如${jetty.home}/lib/ext），让所有WAR包通过父类加载器（系统/扩展类加载器）加载同一个LogRecord类实例，从根本上避免类加载隔离导致的类型不一致。
• 调整WebAppClassLoader配置：在每个WAR的WEB-INF/jetty-web.xml中添加配置，指定x.jar对应的根包由父类加载器优先加载，示例配置如下：

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
  <!-- 开启父类加载器优先级 -->
  <Set name="parentLoaderPriority">true</Set>
  <!-- 指定x.jar的根包，-表示让父类加载器优先加载该包下的类 -->
  <Call name="prependServerClass">
    <Arg>-com.yourpackage.x</Arg>
  </Call>
</Configure>

• 构建阶段统一依赖管理：使用Maven/Gradle等构建工具时，将x.jar的依赖范围设置为provided，确保WAR包打包时不会将x.jar包含到自身的WEB-INF/lib中，而是依赖Jetty全局环境提供的jar包。

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