우리는 어떻게 대규모에서 중복 주문을 제거했는가: EyecareWell의 Python 포스트모템

Source: Dev.to

Introduction — A Production Incident

EyecareWell 은 Shopify 기반 전자상거래 플랫폼과 Windows 블루라이트 필터 애플리케이션을 운영합니다. 일일 주문량이 증가하면서, 프로덕션 사고가 발생했습니다: 중복 웹훅 실행으로 인해 주문이 중복 생성되고 재고가 어긋났습니다.

Incident Summary

• 주문 중복 생성
• 시스템 간 재고 불일치
• Shopify에서 반복되는 웹훅 재시도

Root Cause Analysis

웹훅 엔드포인트가 동기식이며 멱등성을 보장하지 않았습니다. Shopify는 응답이 타임아웃을 초과하면 이벤트를 재시도하는데, 이로 인해 레이스 컨디션과 중복 쓰기가 발생했습니다.

Architecture Before

• Flask 기반 웹훅 엔드포인트
• 직접 DB 쓰기
• 백그라운드 처리 없음
• 중복 방지 로직 없음

Architecture After

• FastAPI 비동기 엔드포인트
• Redis 기반 멱등성 관리
• Celery 백그라운드 워커
• 즉시 HTTP 응답

Key Python Implementation

if redis.exists(event_id):
    return {"status": "duplicate"}
redis.set(event_id, "processing", ex=3600)

Observability Improvements

• 구조화된 로깅
• 재시도 메트릭
• 오류 알림

Results

• 수정 후 중복 주문 0건
• 웹훅 지연 시간 70 % 감소
• 안정적인 재고 정합성 유지

Lessons Learned

• 웹훅은 항상 재시도될 수 있다고 가정할 것
• 멱등성은 선택 사항이 아니다
• 비동기 처리로 신뢰성 향상

Why This Matters

이 아키텍처는 EyecareWell이 안전하게 확장하면서 건강 중심 제품에 대한 신뢰를 유지할 수 있게 합니다.

Conclusion

이 사례 연구는 체계적인 Python 백엔드 설계가 전자상거래 시스템에서 실제 프로덕션 문제를 해결하는 방법을 보여줍니다.