Spring Boot 2.7.0升级至3.0.2时遇IBM MQ类型转换异常求助

问题原因 #

Spring Boot 3.0基于Spring 6，已全面从Java EE的javax.* API切换到Jakarta EE的jakarta.* API，其中JMS核心接口从javax.jms.ConnectionFactory变为jakarta.jms.ConnectionFactory。

旧版本的IBM MQ JMS客户端（9.2.x及以下）仅实现了Java EE规范的javax.jms.ConnectionFactory，无法兼容Spring Boot 3要求的Jakarta版接口，因此触发ClassCastException。

解决方案 #

1. 升级IBM MQ客户端至支持Jakarta JMS 3.0的版本 #

IBM MQ从9.3.0版本开始正式支持Jakarta JMS 3.0规范，需将MQ客户端依赖升级到9.3.0或更高稳定版本：

Maven依赖示例：

<dependency>
    <groupId>com.ibm.mq</groupId>
    <artifactId>mq-jms-client</artifactId>
    <version>9.3.3.0</version>
</dependency>

Gradle依赖示例：

implementation 'com.ibm.mq:mq-jms-client:9.3.3.0'

2. 清理冲突依赖 #

移除项目中所有旧的Java EE JMS相关依赖（如javax.jms:jms-api），避免与Spring Boot 3自带的jakarta.jms:jakarta.jms-api产生依赖冲突。

3. 修正代码中的类型引用 #

确保代码中使用Jakarta版的JMS接口：

• 注入或声明的连接工厂类型应为jakarta.jms.ConnectionFactory
• 新版本的com.ibm.mq.jms.MQConnectionFactory已实现jakarta.jms.ConnectionFactory，可直接实例化使用

配置类示例：

import com.ibm.mq.jms.MQConnectionFactory;
import com.ibm.mq.constants.WMQConstants;
import jakarta.jms.ConnectionFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jms.core.JmsTemplate;

@Configuration
public class JmsConfiguration {

    @Bean
    public MQConnectionFactory mqConnectionFactory() {
        MQConnectionFactory factory = new MQConnectionFactory();
        factory.setHostName("mq-host");
        factory.setPort(1414);
        factory.setQueueManager("QMGR_NAME");
        factory.setChannel("CHANNEL_NAME");
        factory.setTransportType(WMQConstants.WMQ_CM_CLIENT);
        // 按需设置认证信息
        // factory.setStringProperty(WMQConstants.USERID, "username");
        // factory.setStringProperty(WMQConstants.PASSWORD, "password");
        return factory;
    }

    @Bean
    public JmsTemplate jmsTemplate(ConnectionFactory connectionFactory) {
        JmsTemplate template = new JmsTemplate();
        template.setConnectionFactory(connectionFactory);
        template.setDefaultDestinationName("DEFAULT_QUEUE");
        return template;
    }
}

4. 适配Spring Boot自动配置（可选） #

若使用Spring Boot的IBM MQ自动配置，确保配置文件（application.yml/application.properties）中的参数正确：

spring:
  jms:
    ibm:
      queue-manager: QMGR_NAME
      channel: CHANNEL_NAME
      host: mq-host
      port: 1414
      username: username
      password: password

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