Quick Reference

打电话 / 留言分流速查

服务之间只有两种说话方式。判断只看一句:「我下一步要不要用他的答案?」要——打电话(Dubbo)。不要——留言(RocketMQ)。

三个词的位置

RPC
「打电话」这个概念的学名。远程过程调用。
Dubbo
本项目用的电话机。阿里系,与 Nacos / RocketMQ 配套。
Dubbo 协议
电话线上的语言。研发说「走 dubbo 协议」指这个,产品岗不用管。

对照

打电话 · Dubbo
留言 · RocketMQ
说完之后
站着等回答
直接走
对方不在
打不通,你这边报错
留言躺着,他回来再看
什么时候用
下一步要用他的答案
只是通知他去干活
钱的事
事务中间就打出去,回滚撤不回
AFTER_COMMIT 落库后才发
坏了
调用方当场炸,日志很响
发送方无感,消息堆着

坏了怎么认

看到的
哪条线
先问研发一句
RpcException · No provider available · Timeout
电话打不通
「被调的那个服务在测试环境起着吗?注册到 Nacos 了吗?」
没报错,就是没发生;消费端没日志
留言没人看
「消费端服务起着吗?消费组有积压吗?」

电话坏了很响,留言坏了很哑。「显示成功但没生效」一律先查留言那条线——见 Redis / MQ 分流速查。

本项目里的真实对照

vcm-order · FreightSettleServiceImpl.doSettle(),相隔十五行:

行
方式
为什么
321
打电话 driverDubboService.getByUserId()
下一行要用 driver.getId(),等不到就报错
336
留言 publishEvent(AccountFreightPayEvent)
付钱是 user 的活,order 不等;且 AFTER_COMMIT 落库后才发

留言接收端:vcm-user · AccountWaybillFreightPayMQListener(2026-09-22 已修 traceId 接回)。电话线 @DubboReference 在本仓库 250 个文件里出现。

决策表:新需求该走哪条线

场景
走哪条
判据
下单前查余额够不够
电话
下一步要用答案
接单前查司机有没有被拉黑
电话
下一步要用答案
审核通过后推送给司机
留言
只是通知
审核通过后向监测平台上报
留言
只是通知,且第三方可能挂
结算单确认后去付款
留言
钱的事,落库后再动
导出时逐行翻译字典
都不该
逐行远程调用是禁区,见 coding skill 铁律七

来自 Lesson 0009 · 打电话,还是留言。姐妹篇:Redis / MQ 分流速查。