Redis Atomic Lock 기반 Idempotency 구현을 통한 중복 결제 및 데이터 오염 원천 차단

Context

분산 시스템 환경에서 Webhook 전송 시 발생하는 Network Latency와 Vendor의 Retry 메커니즘으로 인한 중복 처리 위험 존재. 특히 비즈니스 로직 처리 시간이 Vendor의 Timeout 임계치(3초)를 초과할 경우 발생하는 중복 과금 및 데이터 정합성 파괴 문제 해결 필요.

Technical Solution

• Vendor 제공 고유 Event ID를 Idempotency Key로 활용하여 요청의 유일성 식별
• API Controller에서 비즈니스 로직을 Queue Worker로 위임하여 응답 시간을 50ms 미만으로 단축하고 Timeout 방지
• Redis의 Atomic Lock을 통해 동일 Event ID에 대한 동시성 제어를 수행하여 중복 실행 원천 차단
• 처리 완료된 Event ID를 캐시에 30일간 기록하여 장기적인 관점의 중복 요청 필터링 구조 설계
• Try-Catch 블록 내 Lock Release 메커니즘을 구현하여 로직 실패 시에만 Retry가 가능하도록 가용성 확보