问题描述：集群桥接队列消息堆积
在使用activemq artemis构建复杂集群环境时，部分用户可能会遇到集群内部桥接队列$.artemis.internal.sf偶发性消息堆积的现象。尽管其他队列的消息能够正常接收和消费，甚至在高负载下也表现良好，但这个内部桥接队列却如同被阻塞一般，导致消息无法正常流转。
典型的生产环境配置可能涉及多层集群（例如“表面”和“深层”集群），每个集群包含多个Master和Slave节点，通过HA策略进行高可用配置。集群连接通常使用静态连接器（static-connectors）定义，并配置了消息负载均衡（message-load-balancing）策略，例如ON_DEMAND。尽管日志显示桥接连接状态正常，且系统日常处理数百万条消息，但消息堆积问题仍然随机发生，不一定与高负载或系统运行时间长短相关，这使得问题难以复现和定位。
根本原因分析：版本特性变更与流控缺陷
经过深入分析，ActiveMQ Artemis 2.22.0版本中集群桥接队列消息堆积问题，通常是由以下两个关键因素共同作用的结果：
producer-window-size 默认值变更 (ARTEMIS-3805) 在ActiveMQ Artemis 2.22.0版本中，cluster-connection配置中的producer-window-size参数的默认值发生了改变。此前，其默认值为-1（表示禁用生产者流控），但在2.22.0版本中，该默认值被修改为1048576（即1 MiB）。这意味着，在没有显式配置的情况下，集群桥接的生产者现在会受到1 MiB的流控窗口限制。虽然此更改在文档的“集群”章节中有所提及，但在“配置索引”章节中有所遗漏。
流控机制缺陷 (ARTEMIS-4003) ActiveMQ Artemis 2.22.0版本中存在一个未知的流控（flow-control）缺陷。当集群桥接在节点之间传输大消息时，这个缺陷可能导致桥接阻塞。此问题在ARTEMIS-4003中被记录并最终在2.26.0版本中得到解决。
因此，当producer-window-size的默认值变为1 MiB，并且系统恰好传输大消息时，2.22.0版本中的流控缺陷就可能被触发，导致集群桥接阻塞，进而引发$.artemis.internal.sf队列的消息堆积。
解决方案
针对ActiveMQ Artemis 2.22.0版本中集群桥接队列消息堆积问题，主要有两种解决方案：
方案一：调整 producer-window-size 配置 (适用于 2.22.0)
通过在broker.xml的cluster-connection配置中显式地将producer-window-size设置回-1，可以禁用生产者窗口流控，从而规避2.22.0版本中的流控缺陷。
原理： 将producer-window-size设置为-1，实际上是恢复了该参数在2.22.0版本之前的行为，即不进行生产者层面的流控。这可以绕过2.22.0版本中与流控相关的bug，允许消息（包括大消息）在桥接上更自由地传输，从而避免阻塞。
配置示例：
在您的broker.xml文件中，找到对应的
-1
注意事项：
- 此方案是一个有效的临时或规避措施，特别是在无法立即升级ActiveMQ Artemis版本的情况下。
- 禁用生产者窗口流控可能会在极端情况下增加Broker的内存压力，如果集群中存在大量未确认的、特别大的消息，可能会占用更多内存。然而，对于解决此特定bug，这是一个被验证的有效方法。
- 修改配置后，需要重启ActiveMQ Artemis实例以使更改生效。
方案二：升级 ActiveMQ Artemis 版本
最根本的解决方案是升级ActiveMQ Artemis到已修复该流控缺陷的版本。
推荐版本： 升级到ActiveMQ Artemis 2.26.0或更高版本。ARTEMIS-4003缺陷已在这些版本中得到修复，这意味着即使producer-window-size保持默认值（1 MiB），集群桥接在处理大消息时也不会再出现阻塞问题。
升级步骤建议：
- 查阅官方文档： 在进行版本升级前，务必仔细阅读ActiveMQ Artemis官方的升级指南和发布说明，了解新版本可能带来的兼容性变化和新特性。
- 备份数据： 在任何升级操作前，务务必对Broker的持久化数据进行完整备份。
- 测试环境验证： 在生产环境升级之前，务必在与生产环境尽可能一致的测试环境中进行充分的测试，以确保升级后的系统稳定运行，并且所有业务逻辑都能正常工作。
- 逐步升级： 对于复杂的集群环境，可以考虑逐步升级策略，例如先升级Slave节点，再升级Master节点，以最小化服务中断时间。
总结与建议
ActiveMQ Artemis集群桥接队列的消息堆积问题，虽然表现为偶发且难以复现，但其根源在于特定版本（2.22.0）中producer-window-size默认值的变更与流控机制的缺陷。
为了确保消息系统的稳定性和可靠性，建议：
- 优先考虑升级： 如果条件允许，升级到ActiveMQ Artemis 2.26.0或更高版本是解决此问题的最彻底和推荐的方法。新版本不仅修复了已知缺陷，通常还包含了性能优化和新功能。
- 配置调整作为临时方案： 如果暂时无法升级，通过调整producer-window-size为-1可以作为有效的临时规避措施。
- 持续监控： 无论采用哪种方案，都应持续监控集群桥接队列（如$.artemis.internal.sf）的消息数量，以及Broker的日志，以便及时发现并处理潜在问题。
- 理解配置： 深入理解ActiveMQ Artemis的各项配置参数及其默认值，对于排查和解决复杂问题至关重要。
通过上述解决方案，可以有效解决ActiveMQ Artemis集群桥接队列消息堆积问题，确保消息在集群间的顺畅传输。
