24시간 자동 지급 회고록

💡 프로젝트 개요

🎯 목적

• 지급 프로세스를 자동화하여 업무 효율성과 정확성을 동시에 향상

✅ 달성한 목표

🕒 24시간 무중단 지급 프로세스 구축

• 스케줄링 기반으로 안정적이고 지속 가능한 자동 지급 시스템 운영

🔧 기존 로직 분석 및 구조 개선

• 기존 v1 지급 로직을 전면 분석하여 지급 흐름을 새롭게 설계
• 수기 지급 시 셀러의 정산 계좌 및 신용 상태를 사람이 직접 검토하던 구조를 시스템이 자동 검증하도록 개선
• 이로 인해 CX팀 리소스 소요가 약 50~70% 감소하는 효과 체감

🔨 레거시 구조 통합

• 지급 프로세스가 PHP, Node.js, Java에 분산되어 있던 구조를 Java 단일 서버로 통합
• 기존에는 Transaction 처리가 없어 데이터 무결성에 문제가 있었지만, 엄격한 트랜잭션 제어로 안정성 확보

🚀 성능 개선

• 동기 처리 → 멀티 스레드 병렬 처리로 전환하여 속도 개선
• 기존에는 신청건이 N개일 경우, 건당 약 1분의 크롤링 시간이 소요되어 전체 처리 시간이 선형적으로 증가하는 구조
• CompletableFuture를 활용해 비동기 병렬 처리 구조로 전환, 다수의 신청건을 동시에 처리할 수 있도록 개선

⚠️ 예외 상황 대응

• 외부 시스템 연동 중 발생할 수 있는 다양한 예외에 철저히 대응
• PaymentWaitException, PaymentFailureException 등의 Custom Exception을 도입해 예외 상황 명확화
• 지급 단계별 STEP을 도입해 문제 지점을 추적 및 모니터링 가능

🛑 긴급 중단 제어 기능

• 지급 중단이 필요한 상황에 대비해 Redis에 상태값을 설정하고 이를 기준으로 프로세스의 흐름을 동적으로 제어

---

🧠 어려움과 해결 과정

1. CompletableFuture와 JPA의 영속성 관리

• 문제:
  • JPA의 영속성 컨텍스트는 ThreadLocal 기반이기 때문에 CompletableFuture.runAsync() 내에서 EntityManager 접근 불가
  • 이로 인해 비동기 로직 내에서 JPA 관련 작업(save(), findById() 등)을 호출하면 LazyInitializationException
    예외가 발생.
• 해결:
  • JPA 기반의 데이터 처리(조회, 저장 등)는 현재 트랜잭션 내의 메인 스레드에서 모두 처리
  • 이후 크롤링 작업만 CompletableFuture로 비동기 분리

2. 외부 시스템 연동 예외 처리

• 문제: 각 단계에서 발생하는 예외를 일관성 있게 처리하기 어려움
• 해결:
  • Custom Exception에 지급 단계 및 원인 정보를 포함
  • 예외 발생 시에도 유연하게 롤백 여부 설정
    (@Transactional(noRollbackFor = { PaymentWaitException.class }) 등)

3. 트랜잭션 경계 관리

• 문제: 트랜잭션의 동작 방식에 대한 경험 부족으로 Rollback 여부 판단이 어려웠음
• 해결: 다양한 상황을 겪으며 트랜잭션의 특성과 동작 시점을 학습하고 적용
• 참고링크: https://techblog.woowahan.com/2606/

🧪 테스트 환경 구성

• 외부 연동을 제외한 내부 로직은 Testcontainer를 활용하여 실제 인프라와 유사한 테스트 환경 구성
• 로컬에서도 Redis, DB, 등의 구성 요소를 포함한 통합 테스트가 가능하도록 설계

관련기사 : https://wowtale.net/2025/01/31/236617/