Spring Boot整合Apache Camel连接IBM MQ遇javax.jms.ExceptionListener缺失异常

核心问题 #

异常java.lang.ClassNotFoundException: javax.jms.ExceptionListener的本质是Spring Boot 3.x基于Jakarta EE 9+规范，所有JMS相关API已从javax.jms迁移到jakarta.jms包下，但当前依赖组合中缺少适配Jakarta的JMS API，或组件版本存在兼容性冲突。

具体解决步骤 #

1. 升级Camel JMS依赖到稳定版 #

你使用的camel-jms-starter 4.0.0-M3是里程碑预览版，存在兼容性风险。替换为Camel 4.x正式稳定版：

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-jms-starter</artifactId>
    <version>4.0.0</version> <!-- 或更高正式版本 -->
</dependency>

2. 显式引入Jakarta JMS API依赖 #

如果调整版本后仍报错，添加Jakarta官方的JMS API依赖，确保API包与IBM MQ客户端兼容：

<dependency>
    <groupId>jakarta.jms</groupId>
    <artifactId>jakarta.jms-api</artifactId>
    <version>3.1.0</version>
</dependency>

3. 修复代码中的配置错误 #

你的mqQueueConnectionFactory方法存在两处明显错误：

• TransportType重复覆盖：先设置了WMQConstants.WMQ_CM_CLIENT（客户端模式），随后又设置CommonConstants.WMQ_CM_BINDINGS（本地绑定模式），后者会覆盖前者。客户端连接需保留WMQ_CM_CLIENT，删除setTransportType(CommonConstants.WMQ_CM_BINDINGS)这一行。
• 配置占位符未解析：keystoreKey = "${keyStorePassword}"和getResourceAsStream("${keyStore}")中的占位符不会自动解析，需通过@Value注入配置值：

  @Value("${keyStorePassword}")
  private String keystoreKey;
  
  @Value("${keyStore}")
  private String keyStorePath;
  
  // 修改加载代码：
  keyStore.load(Thread.currentThread().getContextClassLoader().getResourceAsStream(keyStorePath),
                keystoreKey.toCharArray());
  

4. 移除过时的MQEnvironment配置 #

MQEnvironment.sslSocketFactory = sslSocketFactory是IBM MQ旧版配置方式，你已经通过setObjectProperty(WMQConstants.WMQ_SSL_SOCKET_FACTORY, sslSocketFactory)完成SSL工厂设置，这一行可以直接删除。

依赖兼容性验证 #

最终核心依赖需满足：

• Spring Boot 3.x + Camel 4.x正式版
• IBM MQ Jakarta客户端（com.ibm.mq.jakarta.client）与Jakarta JMS API版本匹配

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