D8-06账务域1 分钟更新于 2026-11
幂等记账
一句话
幂等键要贯穿业务与账务,否则重试就重复记账。
幂等记账
它解决什么
记账接口的幂等键必须由业务传入,服务端只做去重与返回首次结果。为什么不能由服务端生成?因为重试时客户端拿不到同一个键,就会记两笔。幂等键通常是「业务单号 + 事件类型」,唯一索引兜底并发,两层缺一不可。
怎么用
- 业务传幂等键
- 唯一索引兜底
- 重复请求返回首次结果
一个判断
同一笔支付重试三次,账上出现三条分录,说明幂等键是服务端生成的。
边界
幂等的边界是保留期:键保留多久,决定多长窗口内重试是安全的;跨月重试需要更长的保留期,不能只留 24 小时。
一个反例
某平台记账接口的幂等键由服务端用 UUID 生成,一笔支付重试三次,账上出现三条分录,月末试算不平,查了两周才定位。根因是幂等键的生成方搞错了,改由业务传入后才稳定。
常见误判
- 靠数据库唯一索引兜底却不设计键。
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 记账的幂等设计。
相关:记账接口设计
相关阅读