ActiveMQ Artemis虚拟主题消费者收不到消息及消息数异常排查请求

核心问题拆解 #

你的场景存在两个关键异常：虚拟主题消费者停止接收消息、队列消息数统计与实际存储不匹配，结合PagedReferenceImpl日志、NFSv4共享存储、虚拟主题配置，可从以下方向排查：

1. 分页机制元数据错乱（触发PagedReferenceImpl日志） #

• Artemis的分页机制处理虚拟主题独立队列时，若NFSv4的IO延迟或文件锁冲突导致分页文件索引元数据损坏，队列会陷入“认为有大量待处理消息但实际无法读取”的状态，进而停止分发。直接主题消费者的队列未触发该元数据异常，因此仍能正常接收。
• 2.19.1版本存在分页相关已知缺陷，集群+共享存储场景下易出现分页元数据与实际存储不一致的情况，直接导致AddressControl.getNumberOfMessages()返回统计值虚高（如50万），但实际存储无对应消息。

2. NFSv4共享存储的兼容性问题 #

• Artemis的Journal存储依赖强一致性文件IO和可靠文件锁，而NFSv4默认的客户端缓存、延迟写机制会导致主备节点文件状态不一致：
  • 主节点写入的分页元数据可能未同步到NFS存储，备节点切换或主节点重启后读取到脏数据；
  • NFS文件锁在集群场景下可能出现抢占异常，导致分页文件无法正常读写。
• 建议检查NFS挂载参数，尝试添加noac（禁用属性缓存）、sync（强制同步写）参数，降低一致性冲突概率。

3. selectorAware=true配置的潜在冲突 #

• 虚拟主题启用selectorAware=true时，队列会对分页文件中的消息执行选择器过滤逻辑。2.19.1版本中，该逻辑与分页扫描机制存在兼容性BUG，可能导致队列无法正确识别符合条件的消息，进而停止分发，同时错误统计待处理消息数。
• 可临时将selectorAware改为false，观察问题是否复现，验证是否为此配置引发的异常。

4. 版本升级建议 #

• ActiveMQ Artemis 2.19.1是较旧的稳定版本，后续版本（2.20.0及以上）修复了大量集群共享存储、虚拟主题、分页相关缺陷，比如虚拟主题消费者在集群中停止接收、分页元数据统计错误等问题。升级到最新稳定版本是解决此类问题最直接的方案。

临时修复方案 #

• 若需临时恢复服务，可停止集群后清理虚拟主题队列的分页文件（路径为data/paging/[virtual-topic-queue-name]），重启集群后消息分发可恢复，但统计异常的根源仍需通过版本升级或存储优化解决。

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