멱등성(idempotency)이란 무엇이며 분산 시스템에서 왜 중요한가요?

Question

Accepted Answer

**멱등성(idempotency)**은 연산이 한 번 수행되든 여러 번 수행되든 같은 결과를 낸다는 것을 의미합니다. 분산 시스템에서는 재시도와 중복 메시지가 불가피하므로 결정적으로 중요합니다 — 멱등 연산은 이를 안전하게 만듭니다.

## 멱등성이란

```text
연산을 여러 번 하는 것이 한 번 하는 것과 같은 효과를 내면 그 연산은 멱등함:
  → "잔액을 100으로 설정" → 멱등 (몇 번 하든 같은 결과)
  → "잔액에 100 더하기" → 멱등 아님 (각 호출이 바꿈 → 중복되면 틀림!)
→ HTTP에서: GET, PUT, DELETE는 멱등; POST는 보통 아님
```

## 분산 시스템에서 중요한 이유

```text
분산 시스템에서 재시도와 중복은 불가피:
  → 요청이 타임아웃 → 클라이언트가 재시도 → 그러나 원본이 성공했을 수 있음 →
    연산이 두 번 실행 (예: 결제가 두 번 청구! 주문이 두 번 접수!)
  → 메시지 큐는 종종 AT-LEAST-ONCE 전달을 보장 → 중복 발생
  → 네트워크 문제, 장애 → 연산이 재시도됨
→ 연산이 멱등하면 중복/재시도가 안전 (반복해도 해 없음)
→ 이것이 올바름과 안전한 재시도에 필수적.
```

## 멱등성 달성

```text
✓ 멱등성 키 → 클라이언트가 연산마다 고유 키 전송; 서버가 각 키를
  한 번만 처리 (중복 제거) → 같은 키로의 재시도가 안전 (결제/API에 흔함)
✓ 연산을 자연스럽게 멱등하게 설계 (설정 vs 증가; upsert)
✓ 처리된 메시지/요청 ID 추적 → 중복 건너뜀
✓ 컨슈머가 중복 메시지를 안전하게 처리하게 함 (큐가 at-least-once 전달하므로)
```

## 왜 중요한가

멱등성을 이해하는 것은 가치가 있습니다. 재시도와 중복이 불가피한 **분산 시스템에서 올바름에 필수적**이므로 중요한 시스템 디자인 지식이기 때문입니다.

멱등성 — 연산이 한 번 수행되든 여러 번 수행되든 같은 결과를 냄 — 은 분산 시스템에서 **재시도와 중복 메시지가 불가피**하기 때문에 결정적으로 중요합니다. 요청이 타임아웃되어 재시도되는 동안 원본이 실제로 성공했을 수 있고(연산이 두 번 실행 — 결제를 두 번 청구하거나 중복 주문을 접수할 수 있음!), 메시지 큐는 종종 at-least-once 전달을 보장(중복 유발)하며, 네트워크 문제가 재시도를 유발합니다.

연산이 **멱등하면 이 중복과 재시도가 안전**(반복해도 해가 없음)하며, 이것이 올바름에 필수적입니다 — 이를 이해하는 것이 신뢰성 있는 분산 시스템 구축의 핵심 통찰입니다.

그 구분("잔액을 100으로 설정"은 멱등; "100 더하기"는 아님 — 멱등이 아닌 버전은 중복되면 틀린 결과를 내므로 결정적 차이)과 어떤 HTTP 메서드가 멱등한지(GET, PUT, DELETE vs POST)를 이해하면 개념이 명확해집니다.

**멱등성 달성 방법** — **멱등성 키** 사용(클라이언트가 연산마다 고유 키를 보내고 서버가 한 번만 처리해 중복 제거 — 결제와 API에 흔하고 중요한 패턴), 자연스럽게 멱등한 연산 설계(설정 vs 증가, upsert), 처리된 요청/메시지 ID 추적으로 중복 건너뛰기, 컨슈머가 중복 메시지를 안전하게 처리하게 하기 — 을 이해하는 것이 안전한 재시도와 올바른 분산 시스템을 위한 필수 실용 지식입니다.

분산 시스템에서 재시도와 중복은 불가피하고 멱등성이 이를 안전하게(중복이 유발하는 이중 청구 같은 심각한 올바름 버그를 방지) 만들며, 멱등성과 그 달성 방법(멱등성 키, 자연스럽게 멱등한 설계)을 이해하는 것이 올바른 분산 시스템에 필수적이므로, 멱등성을 이해하는 것은 가치 있고 실용적으로 중요한 시스템 디자인 지식입니다 — 재시도와 중복이 불가피한 분산 시스템에서 올바름에 필수적이고, 이중 처리 같은 심각한 버그를 방지하며, 안전한 재시도로 신뢰성 있는 시스템을 구축하는 핵심 개념(특히 멱등성 키)입니다.