什么是 idempotency，idempotency key 如何让 retry 安全？

Question

IT Interview Practice · Accepted Answer

**Idempotency**（幂等性）意味着执行一个操作**多次与执行一次的效果相同**。它之所以重要，是因为网络不可靠：当 client 发出一个请求而 response 从未到达时，它无法判断 server 是否已处理。如果它 retry，一个非幂等的操作可能会运行两次。

## 问题

```text
Client ──POST /payments {$100}──▶ Server   (charges $100 ✓)
Client ◀────────X (timeout)────── Server   (response lost)
Client ──POST /payments {$100}──▶ Server   (charges $100 AGAIN ✗ → $200!)
```

`GET`、`PUT` 和 `DELETE` 天然是幂等的，因此 retry 它们是安全的。`POST` **不是**——这正是重复扣款和重复 order 的来源。

## 解决方案：idempotency key

client 为该逻辑操作生成一个**唯一的 key**（通常是一个 UUID）并在一个 header 中发送它。server 把这个 key 连同结果一起存储；如果同一个 key 再次到达，它返回**已存储的**结果，而不是重新执行。

```http
POST /payments HTTP/1.1
Idempotency-Key: 5f2b8c1e-3a4d-4e6f-9c0b-1a2b3c4d5e6f
Content-Type: application/json

{ "amount": 100, "currency": "usd" }
```

```text
Server logic on receiving a request with an Idempotency-Key:
  1. Look up the key in a store (e.g. Redis/DB).
  2. If found → return the saved response (no re-charge).      ← the retry case
  3. If not  → process, save (key → response), then return.
  (Wrap 3 in a transaction / lock so concurrent retries don't double-execute.)
```

retry 时用**同一个 key** 会得到同样的 `200` 和同一笔 payment——客户只被扣款一次。这正是 Stripe 的 API 的工作方式。

## 为什么这很重要

这道题把为顺利路径（happy path）设计的工程师，与为**失败**设计的工程师区分开来，而后者正是生产可靠性的关键。分布式系统保证超时和部分失败*一定*会发生，所以任何有副作用的 endpoint——支付、下单、转账——都需要一个 retry 方案，而对 `POST` 来说“直接 retry”是危险的。面试官想听到两部分的洞见：其一，幂等性是一个你可以*设计进去*的属性（让 `PUT`/`DELETE` 天然安全，并在 `POST` 无法天然安全时给它一个 **idempotency key**）；其二，那个微妙的并发细节——两个同时到达的 retry 不能都执行，所以 key 检查和写入需要一个 lock 或 unique constraint。把这一点做对，就是给客户扣款一次与扣款两次之间的区别，这就是为什么每一个严肃的支付和商务 API 都实现它。

问题

解决方案：idempotency key

为什么这很重要

相关问题