Spring 6迁移ActiveMQ JMS遇类型转换错误，求依赖配置方案

Spring 6.0 基于Jakarta EE 9+规范，所有JMS相关API的包名已从javax.jms全面切换为jakarta.jms。而ActiveMQ 5.x系列（包括最新的5.18.1）的客户端与连接池实现的仍是javax.jms.ConnectionFactory接口，两者类型不兼容，导致Spring 6的JmsTransactionManager无法完成类型转换，抛出异常。

要解决这个兼容性问题，有两种可行方案，推荐优先采用官方适配的方案：

方案一：迁移至ActiveMQ Artemis（官方Jakarta兼容版本） #

ActiveMQ Artemis是ActiveMQ的下一代产品，完全支持Jakarta EE规范，是Spring 6的最佳适配选择。

1. 替换依赖 #

移除旧的ActiveMQ 5.x依赖：

<!-- 移除ActiveMQ 5.x客户端与连接池依赖 -->
<dependency>
    <groupId>org.apache.activemq</groupId>
    <artifactId>activemq-client</artifactId>
    <version>5.18.1</version>
</dependency>
<dependency>
    <groupId>org.apache.activemq</groupId>
    <artifactId>activemq-pool</artifactId>
    <version>5.18.1</version>
</dependency>

添加ActiveMQ Artemis的Jakarta兼容依赖：

<!-- Artemis Jakarta JMS客户端 -->
<dependency>
    <groupId>org.apache.activemq</groupId>
    <artifactId>artemis-jakarta-client</artifactId>
    <version>2.31.0</version> <!-- 使用最新稳定版 -->
</dependency>
<!-- Spring JMS依赖（已适配Jakarta API） -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jms</artifactId>
    <version>6.0.0</version>
</dependency>

2. 修改Spring配置 #

替换连接工厂为Artemis的实现，并改用Spring自带的连接池：

<!-- Artemis连接工厂 -->
<bean id="messagingConnectionFactory" class="org.apache.activemq.artemis.jms.client.ActiveMQJMSConnectionFactory">
    <property name="brokerURL" value="${messaging.broker.url}" />
    <property name="user" value="${messaging.username}"/>
    <property name="password" value="${messaging.password}"/>
    <!-- 若需要连接状态监听，改用Artemis对应的TransportListener实现 -->
</bean>

<!-- Spring自带的JMS连接池（适配Jakarta API） -->
<bean id="jmsPooledConnectionFactory" class="org.springframework.jms.connection.JmsPoolConnectionFactory"
      init-method="start" destroy-method="stop">
    <property name="connectionFactory" ref="messagingConnectionFactory" />
    <property name="maxConnections" value="${messaging.pool.maxConnections}" />
    <property name="maxSessionsPerConnection" value="${messaging.pool.maxActiveSessionsPerConnection}" />
</bean>

<bean id="messagingTransactionManager" class="org.springframework.jms.connection.JmsTransactionManager">
    <property name="connectionFactory" ref="jmsPooledConnectionFactory"/>
</bean>

方案二：桥接javax与jakarta API（临时方案，不推荐） #

若暂时无法迁移至Artemis，可通过引入桥接依赖强行兼容，但存在潜在风险，不建议长期使用：

<!-- 引入Jakarta与javax的桥接依赖 -->
<dependency>
    <groupId>org.apache.jakartaee</groupId>
    <artifactId>jakarta.jms-api</artifactId>
    <version>3.1.0</version>
</dependency>
<!-- 排除Spring JMS中自带的jakarta.jms-api，避免版本冲突 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jms</artifactId>
    <version>6.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>jakarta.jms</groupId>
            <artifactId>jakarta.jms-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Spring 6已彻底移除对javax.*包的支持，所有JMS组件必须实现jakarta.jms.*接口
• ActiveMQ 5.x无官方Jakarta兼容版本，长期来看迁移至Artemis是唯一可靠方案
• Spring自带的JmsPoolConnectionFactory已完全适配Jakarta API，无需再使用ActiveMQ 5.x的PooledConnectionFactory

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