멱등성

[k9425mino]

📆 일자: 26년 9월 27일(일)

발제 의도

멱등성의 정의를 이해하고, HTTP 메서드와 실제 결제 시나리오에 적용해보며 멱등성이 왜 필요한지 함께 알아보고자 하여 오늘 이렇게 준비하였습니다.

🤔 오늘의 질문

1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?

2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.

3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?

[k9425mino]

1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?

멱등성(Idempotency)은 같은 요청을 여러 번 실행해도 서버에 남는 결과가 한 번 실행했을 때와 같은 성질이다.

같은 API를 두 번 호출했을 때 두 번째 호출이 상태를 더 바꾸지 않아야 멱등하다고 할 수 있다. 예를 들어 DELETE /items/1을 두 번 호출해도 결국 해당 항목이 삭제된 상태라면 멱등하다. 첫 번째 응답이 204, 두 번째 응답이 404처럼 서로 달라도 멱등성은 유지된다.

즉, 멱등성은 응답이 아니라 서버 상태를 기준으로 판단한다. 또한 같은 클라리언트가 같은 요청을 반복한 경우만 따진다. 두 호출 사이에 다른 사용자가 데이터를 바꿔 결과가 달라졌다면, 그건 멱등성 위반이 아니다.

멱등성이 중요한 이유는 네트워크 타임아웃 때문이다. 타임아웃이 나면 클라이언트는 요청이 서버에서 처리됐는지 알 수 없다. 이때 멱등한 API는 안심하고 재시도할 수 있다. 반면 멱등하지 않은 API를 재시도하면 중복 결제 같은 문제가 생길 수 있다.

그래서 결제나 주문 API는 보통 클라이언트가 만든 고유 요청 ID인 Idempotency-Key를 헤더로 받는다. 서버는 같은 키로 들어온 요청을 한 번만 처리하고, 이후 요청에는 저장해 둔 결과를 그대로 돌려준다.

2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.

HTTP에서 멱등성은 같은 요청을 여러 번 보냈을 때 서버에 남는 의도된 결과가 한 번 보냈을 때와 같은 지를 뜻한다.

메서드	멱등성	이유
GET	멱등	리소스를 조회하며, 요청 자체가 리소스 상태를 바꾸지 않는다.
POST	보장되지 않음	같은 생성 요청을 두 번 보내면 리소스가 두 개 생길 수 있다.
PUT	멱등	지정한 리소스를 같은 내용으로 반복해서 저장해도 최종 상태가 같다.
DELETE	멱등	같은 리소스를 반복해서 삭제해도 최종 상태는 '삭제됨'이다.
PATCH	보장되지 않음	변경 방식에 따라 달라진다. 값을 10으로 설정하는 요청은 멱등할 수 있지만, 값을 1 증가시키는 요청은 그렇지 않는다.

이는 메서드의 기본 의미에 따른 분류이다. API 설계에 따라 POST도 앞서 말한 멱등성 키 등을 사용해 중복 처리를 막을 수 있다. 또한 DELETE의 첫 번째와 두 번째 응답 코드가 달라도, 최종 상태가 같다며 멱등성은 유지된다.

3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?

타임아웃이 나도 결제가 실패했다고 단정할 수 는 없다. 서버가 결제를 완료했지만 응답만 클라이언트에 도착하지 않았을 수 있다. 이때 클라이언트가 새 결제 요청으로 재시도하면 이중 결제가 발생할 수 있다.

이를 막으려면 클라이언트가 하나의 결제 시도에 멱등성 키를 부여하고, 재시도할 때도 이와 같은 키를 보내야 한다. 서버는 그 키로 이미 처리한 요청인지 확인해 결제를 다시 실행하지 않고 기존 결과를 반환한다. 같은 키에 다른 결제 내용을 보냈다면 오류로 처리해야 한다.

핵심은 재시도가 새 결제가 아니라, 결과를 확인하려는 같은 요청임을 서버가 알아볼 수 있게 하는 것이다.

[9ga0]

1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?

멱등성(Idempotency)이란 같은 요청을 한 번 보내든 여러 번 보내든 서버의 최종 상태가 동일한 성질을 의미합니다. 예를 들어 사용자의 이름을 특정 값으로 변경하는 요청은 여러 번 실행해도 결과가 같으므로 멱등합니다. 반면 잔액에 일정 금액을 추가하는 요청은 호출할 때마다 결과가 달라지므로 멱등하지 않습니다.

멱등성을 만족하려면 같은 요청을 여러 번 실행했을 때 다음 조건을 만족해야 합니다.

• 서버의 최종 상태가 한 번 실행했을 때와 같아야 합니다.
• 요청이 중복 처리되어 추가적인 변경이 발생하면 안 됩니다.
• 응답 내용이나 상태 코드는 달라질 수 있지만, 최종 결과는 같아야 합니다.

이때 응답 코드까지 항상 같을 필요는 없고, 서버의 최종 상태가 같아야 한다는 점이 중요합니다.

2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.

메서드	멱등성	이유
GET	멱등함	데이터를 조회하며 서버 상태를 변경하지 않음
POST	일반적으로 멱등하지 않음	호출할 때마다 새로운 데이터가 생성될 수 있음
PUT	멱등함	특정 자원을 전달한 내용으로 전체 교체함
DELETE	멱등함	여러 번 요청해도 최종적으로 자원이 없는 상태가 됨
PATCH	보장되지 않음	수정 방식에 따라 결과가 달라질 수 있음

쉽게 외우기
GET: 보여주세요 → 멱등
POST: 새로 추가해주세요 → 일반적으로 비멱등
PUT: 이 상태로 바꿔주세요 → 멱등
DELETE: 없애주세요 → 멱등
PATCH: 일부를 수정해주세요 → 구현에 따라 다름

3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?

결제 요청이 서버에서 정상 처리됐지만 네트워크 문제로 응답만 유실될 수 있습니다. 이때 클라이언트가 실패했다고 판단해 다시 요청하면 같은 주문이 두 번 결제되는 문제가 발생할 수 있습니다.
이를 막기 위해 클라이언트가 결제 요청마다 고유한 Idempotency-Key를 함께 보냅니다. 서버는 처음 보는 키일 때만 결제를 처리하고 그 결과를 저장합니다. 이후 같은 키로 재시도하면 결제를 다시 실행하지 않고 저장된 결과를 반환합니다. 이를 통해 네트워크 오류가 발생해도 클라이언트가 안전하게 재시도할 수 있습니다.