API 설계 결함 제거를 통한 시스템 안정성 및 쿼리 성능 최적화

Context

초기 개발 단계의 단순 기능 구현 중심 설계로 인한 Production 환경의 성능 저하 및 데이터 무결성 훼손 위험 분석. 대규모 데이터셋 증가 시 OFFSET 기반 페이지네이션의 선형적 성능 저하와 네트워크 불안정으로 인한 중복 데이터 생성 문제 직면.

Technical Solution

• Idempotency-Key 헤더 도입을 통한 Mutating Request의 멱등성 보장 및 중복 결제 방지 구조 설계
• UUID 기반 요청 기록과 비즈니스 로직을 동일 Database Transaction으로 묶어 원자성 확보
• OFFSET 방식의 Full Scan 부하를 제거하기 위해 정렬 기준 컬럼을 활용한 Cursor-based Pagination 전환
• COUNT(*) 쿼리 비용 절감을 위해 LIMIT + 1 데이터를 조회하여 has_more 상태를 판별하는 최적화 기법 적용
• Breaking Change 방지를 위해 URL Path Versioning(/v1/)을 초기 설계 단계부터 강제 적용
• DB 부하 분산을 위한 Foreign Key Indexing 필수 적용 및 N+1 Query 제거를 통한 IO 효율화