백엔드 API 멱등성 설계, 멱등키만 발급하면 기술면접에서 떨어지는 진짜 이유
by 그릿 | GROWTH_ESSAY | 2026-11-16
#백엔드 #멱등성 #기술면접 #시스템설계면접관이 백엔드 API 멱등성(Idempotency) 설계에서 확인하려는 핵심은 헤더에 실려온 키를 Redis에 저장하는 코드가 아닙니다. 네트워크 타임아웃이나 동시 중복 요청이 쏟아지는 순간에 처리 중(IN_PROGRESS) 상태와 실패 응답을 데이터 정합성에 맞게 격리했는지 검증하려는 것입니다. 단순히 멱등키만 발급해 중복 호출을 막았다고 답하면 기술면접의 꼬리질문에서 무너집니다.
첫 번째 요청이 처리 중일 때 똑같은 키가 들어오면 어떻게 합니까?
200명 넘게 멘토링을 진행하면서 결제나 주문 도메인을 구현했다는 2~3년차 백엔드 개발자들의 이력서를 자주 봅니다. 멱등키를 Redis에 저장해 중복 결제를 막았다고 적어둡니다. 하지만 제가 "첫 번째 요청의 트랜잭션이 끝나기 전 클라이언트가 재시도 요청을 보내면 어떻게 동작하나요?"라고 물으면 열에 아홉은 얼어붙습니다.
단순히 키 존재 여부만 검사하면 첫 요청이 커밋되기 전 두 번째 요청이 통과해 이중 결제가 터지거나, 캐시된 성공 결과가 없어 에러가 납니다. 요청 수신 즉시 처리 중 상태를 원자적으로 점유하고, 뒤이어 들어온 동일 키 요청에는 409 Conflict를 내리거나 완료될 때까지 안전하게 대기시키는 상태 분리 논리가 필요합니다.
키는 같은데 요청 바디가 완전히 다르면 어떻게 검증합니까?
클라이언트 버그나 재요청으로 인해 멱등키는 동일한데 결제 금액이나 상품 ID가 바뀌어 들어오는 상황이 실무에서 일어납니다.
키만 대조하고 이전 성공 응답을 그대로 반환하면 금융 사고로 이어집니다. 멱등키를 저장할 때 요청 페이로드의 해시값(SHA-256)을 함께 보관해야 합니다. 동일한 키로 요청이 들어왔을 때 바디 해시가 다르면 즉시 400 Bad Request나 422 상태코드로 차단하는 정합성 검증이 백엔드 엔지니어의 기본기입니다.
외부 결제사 타임아웃이 났을 때 캐시를 어떻게 다룹니까?
백엔드가 PG사로 결제 승인 요청을 보냈는데 응답이 없어 소켓 타임아웃이 났습니다. 이때 멱등키 캐시 상태를 어떻게 처리해야 할까요?
비즈니스 실패는 캐싱하여 즉시 실패를 재응답해야 하지만, 일시적 네트워크 장애에서 캐시를 섣불리 영구 실패로 굳히면 안 됩니다. 결제사에 승인 결과 조회 API를 호출해 실제 승인 여부를 대조한 뒤에 최종 상태를 확정해야 합니다.
프레임워크의 어노테이션이나 캐시 명령어 몇 줄로 멱등성을 때우려 하지 마십시오. 실패와 지연이라는 예외 상황에서 숫자를 지켜내는 논리가 백엔드 개발자의 진짜 실력입니다. 지금 내 백엔드 설계와 커리어 방향이 올바른 궤도에 있는지 점검하고 싶다면 https://teamgrit.co/direction 에서 확인해보세요.