Spring Boot升级报错：com.ibm.disthub2.TextMessageImpl与jakarta.jms.TextMessage不兼容

问题原因 #

• Spring Boot 3.x及以上版本全面切换到Jakarta EE规范，JMS相关API从javax.jms包迁移到jakarta.jms包
• 你使用的com.ibm.disthub2.impl.jms.TextMessageImpl是基于旧的javax.jms.TextMessage实现的类，和新的jakarta.jms.TextMessage属于完全不同的API体系，二者没有继承或实现关系，因此无法直接强制转换

修复方案 #

方案1：换用支持Jakarta的IBM客户端 #

检查IBM是否提供了适配Jakarta EE（即jakarta.jms）的disthub2客户端版本，替换当前依赖。这是最彻底的解决方案。

方案2：用Spring JMS抽象层过渡 #

如果暂时无法更换客户端，可借助Spring JMS的抽象层避免直接操作具体Message实现类：

• 代码中优先依赖jakarta.jms.Message或jakarta.jms.TextMessage接口，不要写死TextMessageImpl
• 接收消息时使用Spring的JmsTemplate或@JmsListener注解，Spring会自动处理API适配（只要客户端能兼容Spring的适配层）
• 示例代码：

@JmsListener(destination = "your-queue")
public void handleMessage(jakarta.jms.TextMessage message) throws JMSException {
    String content = message.getText();
    // 业务处理逻辑
}

方案3：临时降级Spring Boot版本 #

如果上述方案无法快速落地，可暂时将Spring Boot降级到2.x版本（该版本仍使用javax.jms API），待后续有兼容客户端后再升级。但这只是应急手段，不建议长期使用。

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