从ActiveMQ Classic迁移至ActiveMQ Artemis需做哪些客户端变更？

是否必须替换客户端连接工厂？ #

不需要强制更换。ActiveMQ Artemis 兼容 ActiveMQ Classic 的 org.apache.activemq.ActiveMQConnectionFactory，只要客户端使用 OpenWire 协议（Classic 默认协议），直接用原有连接工厂就能正常连接 Artemis broker。

如果想用到 Artemis 的原生高级特性（比如 Core 协议的高性能队列、AMQP 1.0 的跨平台能力），可以切换到 org.apache.activemq.artemis.jms.client.ActiveMQConnectionFactory，但这不是迁移的硬性要求。

迁移指南未明确提到的客户端隐性变更点 #

• 协议兼容性细节：OpenWire 协议虽兼容，但 Classic 部分小众高级特性（比如特定自定义消息属性、依赖 Broker 插件的客户端逻辑）可能存在细微差异，建议提前覆盖核心业务场景做兼容性测试。
• 依赖版本对齐：尽量使用与 Artemis broker 版本匹配的客户端依赖（不管是 Classic 还是 Artemis 的客户端 jar），版本差距过大可能引发连接超时、消息解析异常等问题。
• 安全配置同步：若 Artemis 启用了新的安全策略（比如 JAAS 配置调整、SSL/TLS 新参数），客户端需要同步更新对应的安全配置，比如 SSL 上下文、认证凭证格式。
• 消息与事务逻辑验证：Artemis 的消息 ID 生成规则、事务超时机制和 Classic 略有不同，如果客户端依赖这些逻辑做业务幂等性、事务控制，务必提前测试验证兼容性。

能否实现客户端无感知的 Classic/Artemis 切换？ #

完全可以做到，核心方案如下：

• 统一连接入口：让客户端连接到一个统一的虚拟地址（比如负载均衡器 VIP、服务发现节点），后台通过调整路由规则，将请求转发到 Classic 或 Artemis broker，客户端无需修改任何配置。
• 统一协议栈：确保所有客户端使用两者都支持的协议（优先 OpenWire），避免因协议差异导致客户端需要适配不同的连接逻辑。
• 前置兼容性测试：提前完成全量业务场景的兼容性验证，确保同一份客户端代码在两种 broker 上的表现完全一致，避免切换后出现业务故障。

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