「成功」两个字
是一条分水岭
你问 Redis 和 RocketMQ 是什么关系。答案是:没有关系。它们不搭话、不互相调用、图上也没有连线。它们看起来像一类东西,只因为都被叫「中间件」、都不是业务服务。
但这两个东西各管一段,而分界线正好是用户看到「成功」的那一刻。认出这条线,你接到业务反馈的第一句话就能问对。
先看东西在哪:一次「审核通过运单」
货主在鼎流后台点「审核通过」,到司机手机上收到推送,中间发生的事被这条红线劈成两半。
- 网关验身份Redis 取 accessToken · vcm-gateway
- 生成单号Redis Lua 原子自增 · IdUtil
- 写业务库MySQL · 运单状态改成已审核
- 发一条事件vcm-order 发完就走,不等回音
- 推送给司机vcm-message 消费 · 极光推送
- 推给第三方vcm-dts 消费 · 上报平台
- 写日志vcm-log 消费 · 落分表
为什么要有这条线?如果推送、上报、写日志都放在线左边,货主点「审核通过」要等第三方平台响应完才看到结果——慢,而且第三方一挂,审核就点不动了。把它们挪到线右边,主流程就不用替下游承担风险。这就是「解耦」在业务上的意思。
所以它们坏起来,症状完全不同
Redis 挂了,用户当场看到失败:登录不上、单号生成不出来、页面直接报错。没人需要来告诉你——投诉自己会来。
MQ 消费端挂了,用户当场看到的还是「成功」。审核确实通过了、库里状态也改了,只是司机没收到推送。可能几天后才有人反馈。
「当场报错」找 Redis 那一侧,「显示成功但没生效」找 MQ 那一侧。
司机反馈:「今天早上开始登录不上,一直提示登录已失效」
你要先往哪个方向排?
再往下一层:它们存的东西根本不是一类
今天的单号排到 000237、这个 token 还有效
「运单 YD…237 审核通过了」这一条事件
「丢了会怎样」这一行不是我编的,代码里就写着这个差别——
Redis 允许丢,所以有对账。生成单号时,先从数据库取当前最大单号,再和 Redis 里的计数比一下;如果数据库的比 Redis 的大,说明 Redis 掉过数据,就用数据库的值把它补回去,然后才生成:
int staff = maxOrderNum - redisOrderNum;
if (staff > 0) {
// 数据库比缓存大 → 缓存掉数据了,用数据库校准
stringRedisTemplate.opsForValue().set(key, String.valueOf(maxOrderNum));
}
return generateID(prefixEnum);
vcm-common/src/main/java/com/hdcloud/vcm/common/util/IdUtil.java · generateOrderNo()。数据库是真相,Redis 只是个跑得快的副本。
MQ 不允许丢,所以有重试上限。每个消费者都标了 maxReconsumeTimes——消费失败会重投,投够次数才罢休:
@RocketMQMessageListener(
topic = RocketMQConstant.ENV_PRFIX + MqMessageConstant.ORDER_STATUS_RESULT,
maxReconsumeTimes = MqMessageConstant.MAX_RECONSUME_TIMES)
vcm-dts 的 OrderStatusChangeMqConsumer。事件丢了就是真丢了,没有第二个地方能把它找回来——所以必须重试。
货主反馈:「运单昨天就审核通过了,司机一直没收到通知」
你要先往哪个方向排?
为什么右边的问题特别难查
这件事你在 Lesson 0005 已经撞见过一次:trace id 过不了 MQ。
请求在分水岭左边时,一条 trace id 串起所有日志,搜一个字符串就能看全程。可一旦事件进了 MQ,消费端是另一个线程——MDC 是按线程存的,新线程拿不到原来那份,链路就断在这里。
AccountWaybillFreightPayMQListener(vcm-user)收到消息后,DTO 里明明带了 traceId 字段,代码却一次都没读。运费支付的异步段因此查不到链路。
这条缺陷是 Lesson 0005 教学时发现的,2026-09-22 已在分支 fix/mq-traceid-logback-zhongji 修复,待提测。修法不是往 MDC 塞 tid——那个键被 SkyWalking 接管、不读 MDC——而是调框架自带的 LogTraceUtil.addTraceId()。它和你记忆里那个「货主批量支付并发」问题可能相关——排查难本身就有结构性原因。
所以右边出事时,别指望像左边那样搜一个 trace id 就通。要换成按业务单号搜(运单号、支付流水号),因为单号是会被带进消息体的。
落到动作:接到反馈先问这一句
你不需要先判断是谁的问题。只要问一句话,就能把范围砍掉一半:
「当时点完,页面是提示成功了,还是当场就报错了?」
- 当场报错 → 分水岭左边。查登录态、查接口本身、查数据库写入。
- 提示成功但没生效 → 分水岭右边。查 MQ 有没有发出去、消费端有没有消费成功。
- 用户说不清 → 让他截当时的页面,或者去数据库看那条记录的状态到底改没改。状态改了=左边成功了。
这是 Lesson 0006 那个「提问模板」的同一套路——把技能落成一句你真的会说出口的话,而不是一段你记不住的知识。
接着读什么
主源推荐:Apache RocketMQ 官方文档 · 领域模型(中文,一手)。看前两节就够——它开篇讲的正是「为什么要在中间放一个队列」,和这一课的分水岭是同一件事,只是用的是官方术语(生产者 / 主题 / 消费者)。
延伸:Redis 官方 · 分布式锁模式。等你哪天要搞明白「两个人同时点支付会不会重复扣款」,从这里开始。
速查卡:Redis / MQ 分流速查——打印出来贴着,接反馈时照着问。
有任何不清楚的,直接问我。这一课刻意没讲的东西有:MQ 消费失败重试完了会去哪(死信队列)、Redis 的过期策略、为什么有的事件必须保证顺序。想知道哪个,说一声。