Quick Reference
超时与幂等速查
打电话等满 30 秒挂了,结果是不知道,不是失败。对方如果对重复来电回错话,「不知道」就会变成两边永远对不上。
打电话的三种结局
日志
能确定什么
重试安全吗
正常返回
对方说的就是结果
不需要重试
No provider available对方肯定没做
安全
Invoke remote method timeout不知道
只有对方幂等才安全
词汇
- 超时
- 等回话等到上限(网货调中台是 30 秒)就放弃。放弃的是「等」,不是对方的动作。
- 幂等
- 同一个请求来几次,都按「现在的结果」如实回答,不重复做事。
- 漂移
- 同一件事,一个系统记了「做了」,另一个记了「没做」。
- 对账
- 定期把两边的记录拿来比,把漂移的单子找出来。
- 幂等号
- 调用方给每次业务操作一个固定编号,重试时带同一个号;对方见过这个号就直接回上次的结果。例:更换司机的交接请求号。
排查三步(按顺序)
报错原文对事实
报错说的和眼前事实相反(说「未装车」,对方却显示运输中),先怀疑漂移。
两边各查一次
同一件事:对方做了没、几点;我们记了没、几点。一边有一边没 → 漂移。
搜对方完成时刻往前 30 秒
有
timeout→ 超时漂移。没有 → 对方自己做了没通知。
等待时间要对齐
外层要比里层等得久,否则里层拿到成功时外层已经回滚。本项目司机点装车发运的链路(2026-10-09 核对):
哪一手
谁等谁
最多等
在哪设的
①
司机 App → 网货
30 秒
安卓 RetrofitManager / iOS
②
vcm-order → vcm-dts
30 秒
Nacos(Dubbo)
③
vcm-dts → 中台
60 秒
框架 HttpProperties 默认
④
中台内部
未知
—
② < ③:中台耗时在 30~60 秒之间必然漂移。调长等待=止血;幂等=根治;对账=兜底。等多久只决定线画在哪,「不知道」一直在。
幂等需求的写法
按「当前状态 → 再来一次回什么」列表,验收里必须有同一请求连续调两次。
当前状态
再来一次
备注
还没做
正常执行
现有行为
已经做完
回成功,不重复做
要改的
做不了
如实报错
报错要说真话
本项目已知清单(2026-10-08)
接口
重复调用现状
处理
中台 · 确认发车
sendCarConfirm回「存在未装车订单」
已提需求给中台
网货 · 中台撤回
tmsCancelOrder原来回「已分配车辆」
已修,合 test
网货 · 中台推单
tms-order/place原来会建两张单
已修,合 test
中台 · 到达装货 / 到达卸货 / 取消 / 建派车单
未知
需求里请中台回复
来源:Lesson 0013 · 主源 Amazon Builders' Library · Making retries safe with idempotent APIs