在JMS和ActiveMQ这个圈子里泡久了,你会发现大多数问题不是出在“不会用”,而是出在“没理解”。我前段时间就栽在一个看似简单的消息重复消费问题上,查了两天才发现,根子不在Spring Boot代码,而在ActiveMQ的确认机制和重发策略上。这篇就把当时的学习过程、排查链路和一些可以直接抄走的经验整理成“一则”笔记,既讲清楚JMS规范里那几个容易被忽略的点,也会给出实际可用的JMX查询方法,尤其是用TopicSubscriptionViewMBean观察订阅者状态这部分,希望能帮你在遇到类似问题时少走弯路。
如果你是刚接触消息中间件,或者已经在用ActiveMQ但总被奇怪现象困扰,这篇内容会比较对胃口。我会尽量把每一步为什么这么做解释清楚,不光是甩配置和代码。
1. 先从一次“只发不收”的诡异现象讲起
那是一个周五下午,测试环境报了个消息积压的告警:生产者成功发送了一条订单状态变更消息,消费者端却一直没动静。我去看ActiveMQ的Web控制台,Queue的EnqueueCount正常增加,DequeueCount却纹丝不动,消息就这么堆在队列里。更奇怪的是,消费者服务没有任何报错,日志一片安静。
当时第一反应是“消费者没连上”,于是去翻Spring Boot的ActiveMQ配置,连接地址没问题,用户名密码没问题,监听器注解也写了。然后我开始怀疑是不是消费逻辑里try-catch把异常吞了,但排查一圈,消费者方法里完全没有异常捕获,理论上有问题应该会抛出来。
后来我在控制台上点了那条消息的Message ID,顺手查了一下JMSRedelivered标志位,发现消息的DeliveryMode是PERSISTENT,Redelivered是false,一切看起来都很正常。这时候才意识到,问题可能不在消息本身,而在于消费者会话的ACK模式。默认情况下,Spring Boot整合ActiveMQ,如果使用spring.jms.listener.acknowledge-mode不显式配置,实际走的是AUTO_ACKNOWLEDGE。AUTO_ACKNOWLEDGE的意思是,消息只要被消费者成功接收并返回,就自动确认。如果回调方法里因为某种原因抛了异常,事务回滚或确认失败,消息就会重新投递。
但现象是既不确认也不重投,直接卡住。继续深挖之后发现,真正的原因是监听器容器在启动时创建会话失败,但因为配置了重连机制,它一直在后台重试,而SpringBoot默认日志级别下,这个重试过程并不会输出到应用日志里,于是看起来就好像什么都没发生。
这个坑让我明白一件事:ActiveMQ的资料虽然多,但大多数教程只告诉你“怎么连”,很少有人讲清楚“确认、重投、回滚”这三者之间的关系。所以这篇学习笔记,我会从JMS规范里那几个核心概念讲起,再落到ActiveMQ的存储和重发机制,然后用Spring Boot整合场景做串联,最后给出一套直接能用的JMX监控查询方式。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. JMS规范里最容易绕晕的四个基础概念
2.1 Queue和Topic:不是“二选一”,是两种投递语义
很多初学者会把Queue和Topic当成“两种队列”,其实它们代表的是两种完全不同的消息投递语义。
Queue对应点对点模型:一条消息只会被一个消费者消费,哪怕有多个消费者在监听同一个队列,消息也会被负载均衡地分给其中一个。这个模型下,消息一旦被某个消费者成功确认,就会从队列中移除,其他消费者不会再看到。
Topic对应发布订阅模型:一条消息会被广播给所有订阅了该Topic的消费者。这里注意,如果消费者只是临时订阅(Non-Durable Subscription),那么它在线期间才会收到消息,离线期间发布的消息会丢。如果要用持久订阅,需要给订阅者设置一个持久的ClientId和订阅名称。
我在实际项目里见过有人把Topic当作Queue用,消费者设置了普通监听,结果服务重启期间的消息全部丢失,还以为是网络问题。这正是没区分两种模型导致的。
两种模型的选择逻辑其实很简单:
- 业务上希望一条消息只被处理一次,比如订单支付回调、积分变更,选Queue。
- 业务上希望所有关注方都能收到消息,比如商品价格变动、用户上线通知,选Topic。
需要提醒的是,Topic + 持久订阅的实现复杂度比Queue高不少,ActiveMQ要求消费者在连接时设置clientId,并且订阅名称要保证唯一。如果你只是想让多个消费者分摊消息压力,不要用Topic,直接用Queue + 多个监听实例就可以。
2.2 消息确认:AUTO_ACKNOWLEDGE和CLIENT_ACKNOWLEDGE的差别
JMS的Session有几种确认模式,最常见的是:
| 确认模式 | 行为特点 | 典型使用场景 |
|---|---|---|
| AUTO_ACKNOWLEDGE | 消息被consumer接收并成功返回后自动确认 | 默认模式,适合大多数“处理后删除”的业务 |
| CLIENT_ACKNOWLEDGE | 需要手动调用message.acknowledge()确认 |
需要批量确认、或者业务处理成功后才确认的场景 |
| DUPS_OK_ACKNOWLEDGE | 允许重复确认,吞吐高但可能重复投递 | 对消息重复不敏感的场景 |
| SESSION_TRANSACTED | 事务会话,提交事务才确认 | 需要强一致性、多消息同时确认或回滚的场景 |
AUTO_ACKNOWLEDGE最大的坑在于:它默认消费者“只要收到就算成功
