跳到正文
D8-06账务域1 分钟更新于 2026-11

幂等记账

一句话

幂等键要贯穿业务与账务,否则重试就重复记账。

本文目录8 节

幂等记账

它解决什么

记账接口的幂等键必须由业务传入,服务端只做去重与返回首次结果。为什么不能由服务端生成?因为重试时客户端拿不到同一个键,就会记两笔。幂等键通常是「业务单号 + 事件类型」,唯一索引兜底并发,两层缺一不可。

怎么用

  • 业务传幂等键
  • 唯一索引兜底
  • 重复请求返回首次结果

一个判断

同一笔支付重试三次,账上出现三条分录,说明幂等键是服务端生成的。

边界

幂等的边界是保留期:键保留多久,决定多长窗口内重试是安全的;跨月重试需要更长的保留期,不能只留 24 小时。

一个反例

某平台记账接口的幂等键由服务端用 UUID 生成,一笔支付重试三次,账上出现三条分录,月末试算不平,查了两周才定位。根因是幂等键的生成方搞错了,改由业务传入后才稳定。

常见误判

  • 靠数据库唯一索引兜底却不设计键。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 记账的幂等设计。

相关:记账接口设计

相关阅读