Spring Boot SOAP服务启动失败：WebServiceMessageReceiverHandlerAdapter初始化异常

核心原因 #

Spring Boot 3.x全面迁移到Jakarta EE API（原Java EE的javax包已替换为jakarta包），你遇到的类转换异常，是因为项目中混入了基于旧javax API的com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl，无法适配新的jakarta.xml.soap.SAAJMetaFactory接口。即使依赖版本表面一致，也可能是其他依赖间接引入了旧版本的SAAJ组件。

解决方案步骤 #

1. 排查并排除依赖冲突 #

执行依赖树分析命令，找出所有引入javax.xml.soap相关的依赖：

# Maven
mvn dependency:tree | grep -i saaj
mvn dependency:tree | grep -i javax.xml.soap

# Gradle
./gradlew dependencies | grep -i saaj
./gradlew dependencies | grep -i javax.xml.soap

找到冲突的依赖后，在POM中排除旧的javax版本组件，例如：

<dependency>
    <!-- 示例：假设是某个第三方依赖间接引入了旧SAAJ -->
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>com.sun.xml.messaging.saaj</groupId>
            <artifactId>saaj-impl</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.xml.soap</groupId>
            <artifactId>javax.xml.soap-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 明确引入Jakarta版本的SAAJ依赖 #

Spring Boot 3.x需使用适配Jakarta的SAAJ实现，在POM中添加：

<dependency>
    <groupId>com.sun.xml.messaging.saaj</groupId>
    <artifactId>saaj-impl</artifactId>
    <version>3.0.3</version> <!-- 版本需与Spring Boot 3.1.x兼容 -->
</dependency>

注意：Spring Boot 3.1.x默认依赖的SAAJ版本已适配Jakarta，若手动指定需确保版本匹配，避免重复引入。

3. 检查SOAP配置类的API使用 #

确保配置类中使用的是Jakarta EE的API，而非旧javax的：

// 正确：使用jakarta包
import jakarta.xml.ws.Endpoint;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.ws.transport.http.MessageDispatcherServlet;

@Configuration
public class SoapWebServiceConfig {

    @Bean
    public ServletRegistrationBean<MessageDispatcherServlet> messageDispatcherServlet() {
        MessageDispatcherServlet servlet = new MessageDispatcherServlet();
        servlet.setTransformWsdlLocations(true);
        return new ServletRegistrationBean<>(servlet, "/ws/*");
    }

    // 其他SOAP服务配置...
}

若配置类中存在javax.xml.ws.*等旧包导入，需替换为jakarta.xml.ws.*。

4. 清理构建缓存并重新编译 #

# Maven
mvn clean install

# Gradle
./gradlew clean build

验证 #

重新启动项目，若仍有异常，再次检查依赖树，确保所有SAAJ相关依赖均为Jakarta版本，无javax包残留。

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