Quick Reference

超时与幂等速查

打电话等满 30 秒挂了,结果是不知道,不是失败。对方如果对重复来电回错话,「不知道」就会变成两边永远对不上。

打电话的三种结局

日志
能确定什么
重试安全吗
正常返回
对方说的就是结果
不需要重试
No provider available
对方肯定没做
安全
Invoke remote method timeout
不知道
只有对方幂等才安全

词汇

超时
等回话等到上限(网货调中台是 30 秒)就放弃。放弃的是「等」,不是对方的动作。
幂等
同一个请求来几次,都按「现在的结果」如实回答,不重复做事。
漂移
同一件事,一个系统记了「做了」,另一个记了「没做」。
对账
定期把两边的记录拿来比,把漂移的单子找出来。
幂等号
调用方给每次业务操作一个固定编号,重试时带同一个号;对方见过这个号就直接回上次的结果。例:更换司机的交接请求号。

排查三步(按顺序)

  1. 报错原文对事实

    报错说的和眼前事实相反(说「未装车」,对方却显示运输中),先怀疑漂移。

  2. 两边各查一次

    同一件事:对方做了没、几点;我们记了没、几点。一边有一边没 → 漂移。

  3. 搜对方完成时刻往前 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