WebLogic部署Java与WebSphere MQ集成代码遇版本兼容问题求助

问题原因 #

你使用的mq-jms-spring-boot-starter:2.2.0对应IBM MQ客户端版本为9.2.x，而你的MQ服务器是7.5.0.6，高版本客户端与低版本服务器存在API兼容性差异；同时WebLogic可能内置了旧版MQ相关类，导致类路径冲突，触发WMQComponent和JmqiEnvironment版本不兼容的报错。

解决方案 #

1. 调整MQ Spring Boot Starter版本至兼容MQ 7.5的版本 #

IBM MQ 9.x客户端可向下兼容7.5服务器，需选择适配的starter版本：

• 改用mq-jms-spring-boot-starter:1.1.0，其对应MQ客户端版本为9.0.0.4，完全兼容MQ 7.5.0.6。

修改Maven依赖：

<dependency>
    <groupId>com.ibm.mq</groupId>
    <artifactId>mq-jms-spring-boot-starter</artifactId>
    <version>1.1.0</version>
</dependency>

2. 配置WebLogic优先加载应用内的MQ类 #

WebLogic默认可能加载自身内置的MQ相关类，需通过weblogic.xml强制优先使用应用打包的类：
在项目src/main/webapp/WEB-INF目录下创建（或修改）weblogic.xml，添加以下配置：

<?xml version="1.0" encoding="UTF-8"?>
<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xsi:schemaLocation="http://xmlns.oracle.com/weblogic/weblogic-web-app http://xmlns.oracle.com/weblogic/weblogic-web-app/1.7/weblogic-web-app.xsd">
    <container-descriptor>
        <prefer-application-packages>
            <package-name>com.ibm.mq.*</package-name>
            <package-name>com.ibm.msg.client.*</package-name>
        </prefer-application-packages>
    </container-descriptor>
</weblogic-web-app>

3. 修正代码中的常量兼容性问题 #

代码中CommonConstants.WMQ_CM_CLIENT属于旧版MQ客户端常量，可替换为兼容的常量避免版本差异问题：
将

connectionFactory.setIntProperty(JmsConstants.JMS_IBM_MSGTYPE, CommonConstants.WMQ_CM_CLIENT);

替换为：

// 使用MQ客户端标准常量设置客户端传输模式
connectionFactory.setTransportType(WMQConstants.WMQ_CM_CLIENT);
// 若需指定消息类型，使用JMS标准常量
connectionFactory.setIntProperty(JmsConstants.JMS_IBM_MSGTYPE, JmsConstants.JMS_IBM_MSGTYPE_REQUEST);

（需导入com.ibm.mq.jms.WMQConstants类）

验证步骤 #

1. 更新依赖并重新打包应用
2. 部署到WebLogic，检查启动日志是否消除类兼容报错
3. 测试发送消息至MQ队列，确认功能正常

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