Quick Reference

Redis / MQ 分流速查

它们之间没有关系,各管一段。分界线是用户看到「成功」的那一刻——线左边归 Redis,线右边归 RocketMQ。接到业务反馈,照着下面问。

第一句话

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

他说的
意思
往哪查
当场就报错了
分水岭左边没走完
登录态 / 接口本身 / 数据库写入
提示成功,但没生效
左边成功,右边没跑
MQ 发没发出去、消费端消费成功没
说不清
缺证据
看库里那条记录状态改没改——改了=左边成功

本质差别

Redis
RocketMQ
存的是
现在是什么状态
发生过什么事
主流程
停下来等它
发完就走
丢了
可从数据库校准
不能丢,靠重试
坏了
当场报错
显示成功,事后没生效
投诉来源
自己会来
可能几天后才有人说

项目里的具体落点

Redis 管什么(同步段)

用途
在哪
坏了的现象
登录态
vcm-gateway · JwtUtil
提示登录已失效、全员掉线
单号生成
vcm-common · IdUtil
下不了单、生成不出运单号
菜单权限缓存
vcm-base · MenuServiceImpl
改了角色权限但页面没变

IdUtil.generateOrderNo() 会拿数据库最大单号校准 Redis——数据库是真相,Redis 只是跑得快的副本。

MQ 管什么(异步段)

消费方
干什么
坏了的现象
vcm-message
极光推送:单推 / 批量 / 锁屏
操作成功了,司机没收到通知
vcm-dts
向外推审核、状态、费用结果
平台上报没过去、第三方数据对不上
vcm-log
日志落库(时间分表)
查不到某段时间的日志

生产方主要是 vcm-order。vcm-dts 的消费者都设了 maxReconsumeTimes 重试上限。

右边出事时:别再搜 trace id

链路断在 MQ

MDC 按线程存,消费端是另一个线程,trace id 过不去。左边搜一个 id 看全程的办法,在右边不成立。

改用业务单号搜——运单号、支付流水号。单号会被写进消息体,跟着事件走。

已知断点:AccountWaybillFreightPayMQListener(vcm-user)拿到 traceId 字段但从未读取。2026-09-22 已在分支 fix/mq-traceid-logback-zhongji 修复(LogTraceUtil.addTraceId 接回 + finally 清理),待提测。

详见 trace id 排障速查 的「陷阱二」。

容易混的两点

来自 Lesson 0008 · 「成功」两个字,是一条分水岭