升级Spring Boot至3.0.6时出现javax.naming.reference转Jakarta.jms异常

问题描述 #

升级Spring Boot至3.0.6版本，同时将mq-jms-spring-boot-starter更新至3.1.0后，创建QueueConnectionFactory时出现如下异常：

Class javax.naming.reference cannot be cast to Jakarta.jms.QueueConnectionFactory (javax.naming.reference位于加载器‘bootstrap’的java.naming模块中；Jakarta.jms.QueueConnectionFactory位于加载器‘app’的未命名模块中)

核心原因 #

Spring Boot 3.x基于Jakarta EE规范，API包名从javax.*全面迁移到jakarta.*；而旧版本依赖或代码中仍存在javax.jms相关的引用，导致类型加载冲突。

解决步骤 #

• 确认依赖版本兼容性：确保所有IBM MQ相关依赖均为支持Jakarta EE的版本。mq-jms-spring-boot-starter 3.1.0是适配Spring Boot 3.x的正确版本，但需检查是否存在传递依赖引入了旧版javax.jms的包（如com.ibm.mq:mq-jms-client的旧版本）。
• 排查依赖冲突：使用依赖分析工具检查依赖树：
  • Maven：执行mvn dependency:tree
  • Gradle：执行./gradlew dependencies
    找到引入javax.jms的依赖，通过<exclusions>（Maven）或exclude（Gradle）排除，或升级该依赖至支持Jakarta的版本。
• 检查代码中的API引用：确保代码中所有JMS相关的import语句和类型声明都使用jakarta.jms.*包，替换掉所有javax.jms.*的引用，比如：

  // 错误写法
  import javax.jms.QueueConnectionFactory;
  // 正确写法
  import jakarta.jms.QueueConnectionFactory;
  

• 验证自动配置：检查是否存在自定义配置类覆盖了Spring Boot自动配置的QueueConnectionFactory，导致使用了旧的javax类型。若有自定义配置，需修改为使用jakarta.jms.QueueConnectionFactory。

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