JBOSS EAP 6.4转7.2迁移时ConversionNotSupportedException异常排查与解决

这个问题我在之前做EAP版本升级时踩过坑，核心是类加载器冲突加上JMS版本适配问题导致的类型转换失败，下面具体拆解原因和解决办法：

异常产生的核心原因 #

1. 类加载器隔离差异：JBoss EAP 7.x启用了更严格的模块化类加载机制，而EAP 6.x的类加载相对宽松。如果你的应用里自带了IBM MQ的jar包，同时EAP 7.2服务器端也配置了MQ模块，就会出现com.ibm.mq.connector.outbound.ConnectionFactoryImpl（来自应用类加载器）和javax.jms.ConnectionFactory（来自服务器模块类加载器）属于不同的类加载器，JVM会判定这是两个完全不同的类型，自然无法转换。
2. Spring类型转换的局限性：Spring容器在注入Bean时，会严格检查类型匹配，但它无法处理“同全限定名但不同类加载器”的类转换场景，所以会抛出ConversionNotSupportedException，提示找不到转换策略。
3. JMS版本适配问题：EAP 7.2默认支持JMS 2.0，而EAP 6.x是JMS 1.1。如果你的MQ连接工厂配置还是沿用旧的JMS 1.1方式，或者使用了不兼容JMS 2.0的MQ资源适配器，也会导致ConnectionFactory的实现类不符合Spring的预期类型。

具体解决步骤 #

1. 统一IBM MQ的类加载（服务器端配置） #

在EAP 7.2中把MQ的jar包托管给服务器模块加载，避免应用自行加载导致冲突：

• 在$JBOSS_HOME/modules/system/layers/base/com/ibm/mq/main目录下创建文件夹（如果不存在），放入适配EAP 7.2的IBM MQ客户端jar包（比如com.ibm.mq.allclient.jar、com.ibm.mq.jmqi.jar等）。
• 同目录下创建module.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.ibm.mq">
    <resources>
        <resource-root path="com.ibm.mq.allclient.jar"/>
        <resource-root path="com.ibm.mq.jmqi.jar"/>
        <!-- 按需添加其他MQ依赖jar包 -->
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.jms.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

2. 让应用依赖服务器端的MQ模块 #

在你的应用根目录下（WEB-INF或META-INF）创建jboss-deployment-structure.xml，指定应用依赖服务器的MQ模块，避免应用自己加载MQ类：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="com.ibm.mq" export="true"/>
            <module name="javax.jms.api" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

3. 调整Spring配置，通过JNDI获取连接工厂 #

不要在Spring配置中直接实例化IBM的ConnectionFactory实现类，而是通过JBoss的JNDI lookup获取服务器端配置的标准JMS ConnectionFactory：

<bean id="connectionFactory" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="java:/jms/YourMQConnectionFactory"/>
    <property name="resourceRef" value="true"/>
</bean>

这里的java:/jms/YourMQConnectionFactory是你在EAP 7.2管理控制台或standalone.xml中配置的MQ连接工厂的JNDI名称。

4. 清理应用内的冲突jar包 #

检查应用的WEB-INF/lib（或者Maven依赖中的provided配置），移除所有com.ibm.mq.*和javax.jms-api相关的jar包，这些类由服务器模块提供即可，避免重复加载。

5. 确认MQ资源适配器适配EAP 7.2 #

确保你在EAP 7.2中配置的IBM MQ资源适配器是适配JMS 2.0和EAP 7.x的版本，不要使用旧的适配EAP 6.x的资源适配器。

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