跳到正文
G1-05账务核心1 分钟更新于 2026-11

记账的幂等

一句话

同一个业务事件只能记一次账——重试很常见,重复记账是资损。

本文目录7 节

记账的幂等

一次幂等记账

seq业务重试与账务去重
业务系统记账接口账务库post(幂等键 K, 凭证)查 K 是否存在不存在写入凭证(唯一索引 K)重试(同一 K)已存在返回首次凭证号

幂等键怎么设计

业务单号 + 事件类型,例如 order_123:payment_success。

  • 业务单号保证同一笔业务
  • 事件类型区分同一笔业务的多次资金动作(支付、退款、冲正)

唯一索引兜底

接口层查一次、数据库唯一索引再兜一次。并发下只有索引靠得住。

一个反例

某记账接口用自增 ID 当幂等键,重试时 ID 不同,同一笔支付记了两遍,月末不平。现在幂等键由业务生成,加唯一索引兜底。幂等键的生成方错了,后面所有重试都不安全。把它前置到设计阶段,比事后调账省事。

常见误判

  • 用自增 ID 当幂等键(重试时 ID 不同)
  • 用请求体哈希(字段顺序一变就不同)
  • 只在应用层去重(并发穿透)

自查清单

  • 幂等键由业务生成吗
  • 数据库有唯一索引吗
  • 重复请求返回首次结果吗
  • 幂等键的保留期够长吗
  • 有并发重复的测试吗

依据

相关阅读