跳到正文
D2-10交易域1 分钟更新于 2026-11

幂等键设计

一句话

幂等键必须由业务生成——服务端自己编的键,重试时一定不一样。

本文目录7 节

幂等键设计

一次幂等请求

flow幂等键贯穿请求生命周期
业务生成键
请求携带
服务端查重
返回首次结果或执行

键怎么构造

业务单号 + 事件类型:

  • order_123:pay:这笔订单的支付
  • order_123:refund_1:这笔订单的第一次退款
  • batch_9:item_7:批量的第 7 笔

事件类型让同一业务可以有多条幂等记录。

常见错误构造

错误后果
自增 ID重试时 ID 不同,失去幂等
请求体哈希字段顺序/时间戳变化就不同
时间戳每秒都不同
服务端随机生成客户端重试拿不到同一个

保留期

幂等键要保留多久?

  • 覆盖业务可能的重试窗口(通常 24 小时以上)
  • 覆盖退款/冲正窗口(可能数月)

按最长窗口设保留期,而不是按「一天」。

常见误判

  • 只在应用层去重(并发穿透)
  • 没有唯一索引兜底
  • 键里带时间戳

自查清单

  • 键由业务生成吗
  • 键里含事件类型吗
  • 有唯一索引兜底吗
  • 保留期覆盖业务窗口吗
  • 并发重复有测试吗

依据

相关阅读