记一次 RabbitMQ 消息已入队但 Spring Boot 消费者始终未消费的排查过程
本文详细解析了一次 RabbitMQ 消息已成功入队但 Spring Boot 消费者始终未消费的排查过程
1. 问题现象:接口提示发送成功,但邮箱始终收不到验证码
这次排查的问题来自认证服务 s-auth 的邮箱验证码发送功能。
前端调用发送验证码接口后,接口返回一切正常:
json
{
"code": 200,
"msg": "操作成功",
"data": "验证码已发送",
"flag": true
}
服务端日志里也能看到生产者执行成功:
log
准备发送邮箱验证码消息,businessType=blog, email=1179732961@qq.com, exchange=email_exchange
邮箱验证码消息已投递到MQ,businessType=blog, email=1179732961@qq.com
邮箱验证码已缓存到Redis,businessType=blog, email=1179732961@qq.com, expireSeconds=300
但是邮箱就是收不到邮件,而且消费者侧没有任何消费日志。
第一直觉很容易怀疑:
- QQ 邮箱授权码错了
- RabbitMQ 没启动
- 交换机和队列没绑定
- 邮件被拦截进垃圾箱了
但实际往下排,发现这些都不是根因。
2. 现场信息:RabbitMQ 队列数据暴露了关键线索
打开 RabbitMQ 控制台查看 email_queue 队列,发现关键指标如下:
Ready = 10Unacked = 0deliver/get = 0ack = 0Consumers = 4
这个状态非常关键,它说明:
-
消息已经成功进入队列
否则Ready不会持续增长。 -
没有消费者真正把消息取走
因为deliver/get = 0,Unacked = 0,说明根本没有进入“拿到消息待确认”这一步。 -
问题不在发邮件逻辑,而在监听器没有真正工作起来
如果消费者已经开始执行,即使 JSON 解析失败、邮件发送失败,RabbitMQ 控制台里至少也会看到deliver/get增加。
到这里,排查方向就从“SMTP 邮件发送问题”,正式转向了“Spring Boot Rabbit 监听器为什么没有消费消息”。
3. 第一轮排查:先给生产者、消费者、邮件发送三段链路加日志
为了避免盲猜,先在几个关键节点补上日志。
3.1 生产者侧日志
在 UserAuthServiceImpl#sendEmailCode 中打印:
- 准备发送 MQ 消息
- MQ 消息投递成功
- Redis 验证码缓存成功
这样可以快速确认:
- 业务逻辑有没有执行到
- RabbitTemplate 有没有成功投递
- Redis 验证码有没有写进去
3.2 消费者侧日志
在 EmailConsumer 中打印:
- 消费者启动日志
- 收到的原始消息体
- DTO 解析成功日志
- 发信前日志
- 发信完成日志
还额外加了一层最外层 try/catch(Throwable e),确保消费异常不会悄悄被吞掉。
3.3 发邮件实现日志
在 MailServiceImpl#sendSimpleMail 中打印:
- 开始发送邮件
- 每个收件人的发送前日志
- 每个收件人的发送成功日志
- 发送失败异常日志
并且把原来“只打印不抛出”的异常处理改成了“打印后继续抛出”,避免表面看起来消费成功,实际上邮件根本没发出去。
4. 真正的异常点:消费者启动日志都没有打印
加完日志重新启动服务之后,发现一个非常反常的现象:
启动日志里居然连“邮箱消费者已启动,监听队列=email_queue”这条日志都没有。
这意味着什么?
这说明不是“消费者收到了消息但处理失败”,而是:
EmailConsumer这个 Bean 很可能根本没有在启动阶段真正初始化。
如果 Bean 连初始化都没做,自然不会有监听器容器去消费 email_queue。
5. 根因定位:全局懒加载导致 Rabbit 监听器没有正常拉起
继续检查配置文件,发现 s-auth-service 的 application.yml 中有这样一段:
yml
spring:
main:
lazy-initialization: true
这个配置会让 Spring 容器尽可能延迟创建 Bean。
在一般业务 Bean 上这么做问题不大,但在 RabbitMQ 消费者这种依赖容器启动阶段就完成注册的组件上,懒加载会带来非常大的不确定性,最典型的结果就是:
- Bean 没有及时初始化
@RabbitListener监听器容器没有正常拉起- 队列里消息持续堆积
- 控制台显示有消费者,但实际上没有真正消费动作
这也完美解释了为什么:
- 生产者日志正常
- 队列
Ready持续增长 deliver/get = 0- 本地和线上都不消费
6. 修复过程:让消费者显式提前初始化
为了避免直接关闭全局懒加载影响全局性能,我没有粗暴改掉:
yml
spring.main.lazy-initialization=true
而是只对消费者做定点修复。
6.1 显式开启 Rabbit 注解驱动
在启动类中加入:
java
@EnableRabbit
这样可以明确启用 @RabbitListener 机制,避免依赖隐式自动配置。
6.2 消费者 Bean 关闭懒加载
在 EmailConsumer 上增加:
java
@Lazy(false)
这一步的作用是:
即使全局启用了懒加载,这个消费者 Bean 也必须在启动阶段立即初始化。
6.3 简化监听器写法
原本类上和方法上同时出现了监听声明,容易让排查复杂化。后来收敛成更直接的写法:
java
@RabbitListener(queues = EMAIL_QUEUE, concurrency = "1")
public void process(byte[] data) {
...
}
这样可以让监听逻辑更清晰,排查时也更容易观察。
7. 修复后的验证方式
修复后,再次启动服务,优先关注两类日志:
7.1 启动日志
如果修复生效,启动阶段应该能看到:
log
邮箱消费者已启动,监听队列=email_queue
这说明消费者 Bean 已经真正初始化。
7.2 发验证码后的消费日志
重新调用发送验证码接口后,应该依次看到:
log
邮箱消费者收到消息,queue=email_queue, bytes=...
邮箱消费者消息解析成功,dto=...
邮箱消费者开始发送邮件,businessType=blog, to=..., subject=验证码
开始发送简单邮件,from=..., nick=..., toCount=1, subject=验证码
邮件发送成功,to=..., subject=验证码
邮箱消费者处理完成,businessType=blog, to=...
如果这几条都能出现,说明整条链路已经打通。
8. 结论总结
这次问题表面上看像是:
- RabbitMQ 版本问题
- 邮箱授权码问题
- 消费者业务代码问题
但真正根因并不在这些点上,而是:
Spring 全局懒加载导致 RabbitMQ 消费者 Bean 没有按预期初始化,监听器容器没有真正拉起。
本次排查得到的经验
-
接口返回成功,不代表消息已经被消费
生产者成功只能说明消息进了交换机/队列,不能说明消费者执行了。 -
RabbitMQ 控制台的
Ready / Unacked / deliver/get / ack非常重要
这几个指标可以快速判断问题是在生产端、消费端,还是处理逻辑内部。 -
消费者启动日志非常关键
如果连 Bean 初始化日志都没有,优先怀疑监听器没有真正注册。 -
全局懒加载要谨慎使用
对 Rabbit 监听器、定时任务、消息消费者、启动时初始化组件这类 Bean 来说,懒加载很容易带来隐蔽问题。 -
日志要覆盖“发消息 -> 入队 -> 收消息 -> 发邮件”整个链路
只有链路日志完整,排查才不会停留在猜测阶段。
9. 最终修复点
最终实际修复主要包括:
- 在启动类中显式增加
@EnableRabbit - 在
EmailConsumer上加@Lazy(false) - 给生产者、消费者、邮件发送实现补充完整日志
- 邮件发送失败时不再静默吞异常,而是继续抛出
这次问题排完之后,再看 email_queue 队列状态就会很直观:
Ready不再持续堆积deliver/get开始增长ack正常增长
至此,邮箱验证码链路恢复正常。