←AI 实践笔记
Lesson 0008 · 约 9 分钟

「成功」两个字
是一条分水岭

你问 Redis 和 RocketMQ 是什么关系。答案是:没有关系。它们不搭话、不互相调用、图上也没有连线。它们看起来像一类东西,只因为都被叫「中间件」、都不是业务服务。

但这两个东西各管一段,而分界线正好是用户看到「成功」的那一刻。认出这条线,你接到业务反馈的第一句话就能问对。

先看东西在哪:一次「审核通过运单」

货主在鼎流后台点「审核通过」,到司机手机上收到推送,中间发生的事被这条红线劈成两半。

同步 · 你在等它
Redis 的地盘
  1. 网关验身份Redis 取 accessToken · vcm-gateway
  2. 生成单号Redis Lua 原子自增 · IdUtil
  3. 写业务库MySQL · 运单状态改成已审核
页面显示「成功」
分水岭
异步 · 你没在等
RocketMQ 的地盘
  1. 发一条事件vcm-order 发完就走,不等回音
  2. 推送给司机vcm-message 消费 · 极光推送
  3. 推给第三方vcm-dts 消费 · 上报平台
  4. 写日志vcm-log 消费 · 落分表

为什么要有这条线?如果推送、上报、写日志都放在线左边,货主点「审核通过」要等第三方平台响应完才看到结果——慢,而且第三方一挂,审核就点不动了。把它们挪到线右边,主流程就不用替下游承担风险。这就是「解耦」在业务上的意思。

所以它们坏起来,症状完全不同

线左边坏 · 当场就知道

Redis 挂了,用户当场看到失败:登录不上、单号生成不出来、页面直接报错。没人需要来告诉你——投诉自己会来。

线右边坏 · 事后才发现

MQ 消费端挂了,用户当场看到的还是「成功」。审核确实通过了、库里状态也改了,只是司机没收到推送。可能几天后才有人反馈。

这一课要带走的一句

「当场报错」找 Redis 那一侧,「显示成功但没生效」找 MQ 那一侧。

Retrieval Practice · 1 / 2

司机反馈:「今天早上开始登录不上,一直提示登录已失效」

你要先往哪个方向排?

再往下一层:它们存的东西根本不是一类

Redis
RocketMQ
存的是
现在是什么状态
今天的单号排到 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。事件丢了就是真丢了,没有第二个地方能把它找回来——所以必须重试。

Retrieval Practice · 2 / 2

货主反馈:「运单昨天就审核通过了,司机一直没收到通知」

你要先往哪个方向排?

为什么右边的问题特别难查

这件事你在 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 就通。要换成按业务单号搜(运单号、支付流水号),因为单号是会被带进消息体的。

落到动作:接到反馈先问这一句

你不需要先判断是谁的问题。只要问一句话,就能把范围砍掉一半:

「当时点完,页面是提示成功了,还是当场就报错了?」

这是 Lesson 0006 那个「提问模板」的同一套路——把技能落成一句你真的会说出口的话,而不是一段你记不住的知识。

接着读什么

主源推荐:Apache RocketMQ 官方文档 · 领域模型(中文,一手)。看前两节就够——它开篇讲的正是「为什么要在中间放一个队列」,和这一课的分水岭是同一件事,只是用的是官方术语(生产者 / 主题 / 消费者)。

延伸:Redis 官方 · 分布式锁模式。等你哪天要搞明白「两个人同时点支付会不会重复扣款」,从这里开始。

速查卡:Redis / MQ 分流速查——打印出来贴着,接反馈时照着问。

有任何不清楚的,直接问我。这一课刻意没讲的东西有:MQ 消费失败重试完了会去哪(死信队列)、Redis 的过期策略、为什么有的事件必须保证顺序。想知道哪个,说一声。