WebSphere 8.5.5.20部署Spring Boot 1.5.22后API调用报类型转换错误求助

这个错误的核心原因是WebSphere自带的Axis2 JAX-WS实现与应用依赖的CXF组件类加载冲突——即使设置父类优先，WebSphere的Axis2代理类仍会被优先加载，导致类型转换失败。以下是针对性的解决步骤：

1. 修改类加载顺序为PARENT_LAST #

WebSphere默认的父类优先（PARENT_FIRST）会让容器自带的Axis2类先加载，覆盖应用的CXF类。需要切换为子类优先：

• 登录WebSphere控制台，进入应用程序 > 你的Spring Boot应用 > 类加载和更新检测
• 选择类加载顺序：应用程序类加载器先加载（PARENT_LAST）
• 保存配置并重启应用

2. 配置WebSphere部署描述符，优先加载应用的CXF类 #

在应用的WEB-INF目录下创建或修改ibm-web-ext.xml，添加包和资源优先级配置，强制WebSphere使用应用内的CXF实现：

<ibm-web-ext xmlns="http://websphere.ibm.com/xml/ns/javaee"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
              version="1.0">
    <classloader-mode>PARENT_LAST</classloader-mode>
    <!-- 优先加载应用内的JAX-WS和CXF相关包 -->
    <prefer-application-packages>
        <package-name>javax.jws.*</package-name>
        <package-name>javax.xml.ws.*</package-name>
        <package-name>org.apache.cxf.*</package-name>
        <package-name>org.apache.ws.*</package-name>
    </prefer-application-packages>
    <!-- 优先使用应用内的JAX-WS提供者配置 -->
    <prefer-application-resources>
        <resource-name>META-INF/services/javax.xml.ws.spi.Provider</resource-name>
        <resource-name>META-INF/services/org.apache.cxf.*</resource-name>
    </prefer-application-resources>
</ibm-web-ext>

3. 确认CXF依赖的打包配置 #

确保Maven/Gradle将CXF依赖打包到WAR的WEB-INF/lib目录中，避免依赖被标记为provided：

Maven示例： #

<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-frontend-jaxws</artifactId>
    <version>3.5.5</version>
    <scope>compile</scope> <!-- 必须是compile，不能是provided -->
</dependency>
<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-transports-http</artifactId>
    <version>3.5.5</version>
    <scope>compile</scope>
</dependency>

4. 验证JAX-WS提供者是否为CXF #

在应用启动代码中添加日志输出，确认使用的是CXF的JAX-WS提供者：

// 可放在Spring Boot启动类的run方法中
System.out.println("当前JAX-WS提供者: " + System.getProperty("javax.xml.ws.spi.Provider"));

正确输出应为：org.apache.cxf.jaxws.spi.ProviderImpl，若不是则说明配置未生效，需重新检查ibm-web-ext.xml的配置。

5. 规范CXF客户端的创建方式 #

确保使用CXF原生API创建客户端，避免触发WebSphere的Axis2代理：

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

// 创建CXF客户端实例
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
factory.setServiceClass(YourTestService.class);
factory.setAddress("http://localhost:8080/api/test1");
YourTestService client = (YourTestService) factory.create();

内容的提问来源于stack exchange，提问作者El Mehdi Es-safi