Java8升级至17后容器中java.util.ServiceLoader无法加载SAAJ提供者求助

一、类加载器与ServiceLoader机制排查 #

• 强制指定SAAJ实现类：绕过容器中异常的ServiceLoader自动发现逻辑，直接通过系统属性指定实现类。可以在应用启动时添加JVM参数：

  -Djakarta.xml.soap.SAAJMetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl
  

  或者在SOAP服务调用前的初始化代码中主动设置：

  System.setProperty("jakarta.xml.soap.SAAJMetaFactory", "com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl");
  

  注意要确保这个设置在WebserviceTemplate等SOAP相关类加载前执行，比如放在Spring Boot的@PostConstruct方法或者启动监听器中。

• 检查容器类加载隔离配置：容器环境（如Tomcat、K8s自定义容器）可能存在类加载器隔离策略，导致SAAJ相关类未被正确加载。对比正常应用和异常应用的部署配置：

  • 确认是否禁用了类加载器双亲委派，或者设置了自定义类过滤规则
  • 解压应用包，用jar tf app.jar | grep saaj命令验证BOOT-INF/lib中是否包含saaj-impl依赖，且版本与本地运行环境一致

• 排查HK2 ServiceLoader干扰：容器日志显示尝试加载HK2的ServiceLoader，说明其逻辑覆盖了JDK原生实现。可以：

  • 在pom中找到引入HK2的依赖，添加<exclusions>排除org.glassfish.hk2:osgi-resource-locator
  • 若无法排除，添加该依赖的完整兼容版本，确保osgi-resource-locator类能被正常加载

二、线程上下文类加载器问题 #

• 显式设置线程上下文类加载器：不同线程（调度器线程、端点请求线程）的上下文类加载器可能不一致，导致ServiceLoader无法找到提供者。在SOAP调用代码块中强制切换类加载器：

  ClassLoader originalLoader = Thread.currentThread().getContextClassLoader();
  try {
      // 切换为应用自身的类加载器
      Thread.currentThread().setContextClassLoader(getClass().getClassLoader());
      webserviceTemplate.marshalSendAndReceive(/* 调用参数 */);
  } finally {
      // 恢复原类加载器
      Thread.currentThread().setContextClassLoader(originalLoader);
  }
  

• 检查线程池配置：对比正常应用的线程池（Spring TaskScheduler、Tomcat请求线程池）配置，确认异常应用是否自定义了线程池的类加载器属性，导致部分线程无法加载SAAJ类。

三、打包与部署验证 #

• 检查打包完整性：异常应用可能因打包插件配置问题，丢失了SAAJ的服务注册文件。解压应用包后，查看META-INF/services/jakarta.xml.soap.SAAJMetaFactory是否存在，且文件内容为com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl。
• 排查容器依赖冲突：容器基础镜像或内置组件可能包含旧版本的SAAJ/Jakarta EE依赖，与应用依赖冲突。可以：
  • 对于Tomcat，修改context.xml添加<Loader delegate="false"/>，让应用优先加载自身lib中的类
  • 对于Docker容器，检查是否挂载了外部冲突依赖，或更换纯净的Java 17基础镜像

四、版本兼容性验证 #

• 确认SAAJ依赖版本：Java 17对应Jakarta EE 9+，必须使用适配Jakarta命名空间的依赖，确保pom中引入的是jakarta.xml.soap:saaj-api和com.sun.xml.messaging.saaj:saaj-impl（建议版本2.0.0+），避免使用旧的javax.xml.soap命名空间依赖。
• 检查Spring版本兼容性：使用WebserviceTemplate时，需确保Spring Framework版本（5.3.x+）或Spring Boot版本（2.6.x+）完全兼容Java 17和Jakarta EE规范。

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