API 幂等设计：避免重复请求的坑

幂等的目标：同一请求重复执行多次，结果保持一致。

核心策略

• 幂等键（Idempotency-Key）+ 结果缓存
• 业务唯一约束（例如订单号唯一）
• 状态机推进只允许一次

一个参考返回结构

{
  "idempotencyKey": "...",
  "status": "SUCCESS",
  "result": {
    "orderId": "123"
  }
}