D2-10交易域1 分钟更新于 2026-11
幂等键设计
一句话
幂等键必须由业务生成——服务端自己编的键,重试时一定不一样。
幂等键设计
一次幂等请求
flow幂等键贯穿请求生命周期
业务生成键
请求携带
服务端查重
返回首次结果或执行
键怎么构造
业务单号 + 事件类型:
order_123:pay:这笔订单的支付order_123:refund_1:这笔订单的第一次退款batch_9:item_7:批量的第 7 笔
事件类型让同一业务可以有多条幂等记录。
常见错误构造
| 错误 | 后果 |
|---|---|
| 自增 ID | 重试时 ID 不同,失去幂等 |
| 请求体哈希 | 字段顺序/时间戳变化就不同 |
| 时间戳 | 每秒都不同 |
| 服务端随机生成 | 客户端重试拿不到同一个 |
保留期
幂等键要保留多久?
- 覆盖业务可能的重试窗口(通常 24 小时以上)
- 覆盖退款/冲正窗口(可能数月)
按最长窗口设保留期,而不是按「一天」。
常见误判
- 只在应用层去重(并发穿透)
- 没有唯一索引兜底
- 键里带时间戳
自查清单
- 键由业务生成吗
- 键里含事件类型吗
- 有唯一索引兜底吗
- 保留期覆盖业务窗口吗
- 并发重复有测试吗
依据
相关阅读