记一次 RabbitMQ 消息已入队但 Spring Boot 消费者始终未消费的排查过程

2026-04-19后端5 分钟134 次阅读
AI 摘要salmon-ai

本文详细解析了一次 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

但是邮箱就是收不到邮件,而且消费者侧没有任何消费日志。

第一直觉很容易怀疑:

  1. QQ 邮箱授权码错了
  2. RabbitMQ 没启动
  3. 交换机和队列没绑定
  4. 邮件被拦截进垃圾箱了

但实际往下排,发现这些都不是根因。

2. 现场信息:RabbitMQ 队列数据暴露了关键线索

打开 RabbitMQ 控制台查看 email_queue 队列,发现关键指标如下:

  • Ready = 10
  • Unacked = 0
  • deliver/get = 0
  • ack = 0
  • Consumers = 4

这个状态非常关键,它说明:

  1. 消息已经成功进入队列
    否则 Ready 不会持续增长。

  2. 没有消费者真正把消息取走
    因为 deliver/get = 0,Unacked = 0,说明根本没有进入“拿到消息待确认”这一步。

  3. 问题不在发邮件逻辑,而在监听器没有真正工作起来
    如果消费者已经开始执行,即使 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 监听器容器没有正常拉起
  • 队列里消息持续堆积
  • 控制台显示有消费者,但实际上没有真正消费动作

这也完美解释了为什么:

  1. 生产者日志正常
  2. 队列 Ready 持续增长
  3. deliver/get = 0
  4. 本地和线上都不消费

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 没有按预期初始化,监听器容器没有真正拉起。

本次排查得到的经验

  1. 接口返回成功,不代表消息已经被消费
    生产者成功只能说明消息进了交换机/队列,不能说明消费者执行了。

  2. RabbitMQ 控制台的 Ready / Unacked / deliver/get / ack 非常重要
    这几个指标可以快速判断问题是在生产端、消费端,还是处理逻辑内部。

  3. 消费者启动日志非常关键
    如果连 Bean 初始化日志都没有,优先怀疑监听器没有真正注册。

  4. 全局懒加载要谨慎使用
    对 Rabbit 监听器、定时任务、消息消费者、启动时初始化组件这类 Bean 来说,懒加载很容易带来隐蔽问题。

  5. 日志要覆盖“发消息 -> 入队 -> 收消息 -> 发邮件”整个链路
    只有链路日志完整,排查才不会停留在猜测阶段。

9. 最终修复点

最终实际修复主要包括:

  1. 在启动类中显式增加 @EnableRabbit
  2. 在 EmailConsumer 上加 @Lazy(false)
  3. 给生产者、消费者、邮件发送实现补充完整日志
  4. 邮件发送失败时不再静默吞异常,而是继续抛出

这次问题排完之后,再看 email_queue 队列状态就会很直观:

  • Ready 不再持续堆积
  • deliver/get 开始增长
  • ack 正常增长

至此,邮箱验证码链路恢复正常。

觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句