从SAP Hybris Commerce 1811迁移至2211时遇[SAAJ 1.3]版本错误求助

错误日志 #

org.springframework.beans.FatalBeanException: Context hybris Global Context Factory couldn't be created correctly due to, Error creating bean with name 'defaultTestTaxJurisdictionService' defined in class path resource [core-spring.xml]: Cannot resolve reference to bean 'webServiceTemplate' while setting bean property 'webServiceTemplate'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'webServiceTemplate' defined in class path resource [core-spring.xml]: Cannot resolve reference to bean 'messageFactory' while setting constructor argument; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'messageFactory' defined in class path resource [core-spring.xml]: Invocation of init method failed; nested exception is org.springframework.ws.soap.SoapMessageCreationException: Could not create SAAJ MessageFactory. Is the version of the SAAJ specification interfaces [SAAJ 1.3] the same as the version supported by the application server?; nested exception is java.lang.NoSuchMethodError: 'javax.xml.soap.MessageFactory javax.xml.soap.MessageFactory.newInstance(java.lang.String)'

问题核心 #

这个错误本质是SAAJ API版本冲突：Hybris 2211依赖的SAAJ最低版本为1.4，而当前环境中存在旧版本1.3。MessageFactory.newInstance(String)是SAAJ 1.4新增方法，1.3版本无此方法，导致反射调用失败。

解决步骤 #

1. 强制统一SAAJ依赖版本 #

根据构建方式明确指定SAAJ相关依赖版本为1.4.x：

• Gradle构建：在项目根目录或扩展的build.gradle中添加：

  dependencies {
      implementation 'javax.xml.soap:saaj-api:1.4.0'
      implementation 'com.sun.xml.messaging.saaj:saaj-impl:1.4.0'
  }
  

• Ant构建：在project.properties中配置：

  dependency.saaj-api.version=1.4.0
  dependency.saaj-impl.version=1.4.0
  

2. 彻底清理缓存与构建产物 #

执行Hybris清理命令，确保旧依赖完全移除：

./ant clean all

手动删除以下目录，避免残留缓存：

• hybris/temp
• hybris/bin/platform/temp
• hybris/bin/custom/[你的扩展]/temp

3. 调整应用服务器类加载顺序 #

若部署到Tomcat、JBoss等外部服务器，需确保Hybris类加载优先级高于服务器自带的SAAJ库：

• Tomcat：修改conf/catalina.properties，将Hybris的lib目录加入common.loader最前面：

  common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${HYBRIS_HOME}/bin/platform/lib/*.jar
  

4. 排查自定义扩展的依赖冲突 #

检查所有自定义扩展的依赖树，排除旧版本SAAJ库：

• 使用Gradle查看依赖树：

  ./gradlew dependencies
  

• 找到引入旧SAAJ版本的依赖，通过exclude排除：

  implementation('com.yourcompany:your-custom-extension') {
      exclude group: 'javax.xml.soap', module: 'saaj-api'
  }
  

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