WebSphere 6迁移至8.5：CXF与内置AXIS2类兼容问题求助

我之前在迁移老版本WebSphere应用到8.5时，也碰到过一模一样的类转换错误——本质就是WebSphere自带的Axis2 JAX-WS引擎和你应用中的CXF库在类加载层面发生了冲突，导致JVM把Axis2的代理类当成了CXF的ClientProxy来用。

下面是我亲测有效的解决步骤，结合IBM文档的基础上补充了关键细节：

1. 强制设置应用类加载顺序为「父类最后」 #

WebSphere默认的类加载策略是父类优先（Parent First），这意味着WAS自带的Axis2类会先被加载，直接覆盖你应用打包的CXF类。你需要：

• 登录WAS控制台，找到你的应用，进入「类加载器」设置
• 将类加载顺序改为Parent Last（父类最后加载）
• 如果是EAR应用，还要确认模块的类加载器模式设置为「应用程序」或「模块」级，确保每个模块都能优先加载自身的库

2. 在MANIFEST.MF中排除WAS自带的JAX-WS相关API #

通过MANIFEST.MF告诉WebSphere不要把自带的Axis2和JAX-WS API注入到你的应用中，添加以下配置：

IBM-API-Package-Exclusions: org.apache.axis2.*, javax.jws.*, javax.xml.ws.*, javax.xml.bind.*

这样应用会完全使用你打包的CXF提供的JAX-WS实现，而不是WAS自带的Axis2版本。

3. 清理并规范CXF依赖打包 #

• 确保你使用的CXF版本和WAS 8.5兼容（推荐CXF 2.7.x或3.0.x版本，避免使用过于新的3.2+版本，可能存在API不兼容）
• 在Maven/Gradle中打包时，排除掉JDK或WAS已提供的API依赖（比如javax.xml.ws-api、javax.jws-api），只保留CXF的实现类依赖，避免重复类加载
• 检查你的WAR/EAR包，确保WEB-INF/lib下只有CXF的相关库，没有混入Axis2的jar包

4. 确保客户端代理用纯CXF方式创建 #

不要混合使用Axis2和CXF的客户端创建代码，确保你的SOAP客户端是通过CXF的API生成的：

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

// 创建CXF代理工厂
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
factory.setServiceClass(YourSoapServiceInterface.class);
factory.setAddress("http://your-soap-service-url");

// 获取CXF代理实例
YourSoapServiceInterface client = (YourSoapServiceInterface) factory.create();

如果之前的代码有使用Axis2的JAXWSProxyHandler相关逻辑，要全部替换为CXF的实现。

5. 验证WAS全局JAX-WS引擎设置 #

虽然你已经按IBM文档操作，但还是要再确认一次：

• 进入WAS控制台的「应用程序服务器 > 你的目标服务器 > Web服务 > JAX-WS引擎」
• 选择「使用第三方JAX-WS Web服务引擎」选项
• 保存配置后重启服务器，确保设置生效

这些步骤组合起来，基本上就能彻底隔离WAS自带的Axis2和应用的CXF类加载，解决JAXWSProxyHandler incompatible with ClientProxy的错误。

内容的提问来源于stack exchange，提问作者Raul Eduardo Perez