幂等键流程
幂等键流程
请求: POST /generate {idempotency_key: uuid}
1 查键表：已存在 → 直接返回原结果
2 不存在 → 执行并把结果与键一起落库
3 并发同键 → 加锁等待或返回处理中
键保留期: 24h（覆盖重试窗口）| 范围 | 付费、发信、写库等副作用操作必须幂等 |
|---|---|
| 键来源 | 由服务端签发，客户端仅回传使用 |
调用幂等性设计
网络抖动与重试会让同一请求到达两次：用幂等键把重复请求归并到一次执行；写操作先查后写或落去重表，回执可复用。
易错点
- 重试链路缺少幂等键，重复扣费或重复发信
- 幂等键由客户端随意生成且可预测，可被滥用
数据来源与参考
- Stripe API《Idempotent requests》文档；RFC 9110 HTTP 语义（幂等方法）