Idempotency 패턴 적용을 통한 분산 시스템 통합 안정성 확보

Context

ERP, API, AI Workflow 등 외부 시스템 통합 시 발생하는 요청 재시도 및 Webhook 중복 전송으로 인한 데이터 불일치 문제 발생. 단일 요청의 성공 여부와 응답 수신 여부가 일치하지 않는 분산 환경의 불확실성으로 인한 중복 주문 및 메일 발송 등의 사이드 이펙트 노출.

Technical Solution

• 동일 입력에 대해 항상 동일한 결과를 보장하는 Idempotency 원칙 기반의 설계 도입
• 단순 생성 로직을 사전 존재 여부 확인 및 Update 처리로 전환하여 Duplicate 데이터 생성 방지
• Multi-step flow 내 장애 발생 시 처음부터 재시작하는 방식이 아닌 중단 지점부터 재개하는 상태 관리 설계
• 결제 및 알림 발송 등 외부 Side effects 발생 시점에 실행 제어 로직을 추가하여 중복 실행 원천 차단
• 모든 요청이 재시도될 수 있다는 가정하에 설계하는 'Retry-first' 관점의 아키텍처 전환