GraphQL을 이용한 QueryFacade 개발기

이 게시물은 당근 로컬 비즈니스실에서 복잡한 도메인 데이터 조합 문제를 해결하기 위해 GraphQL 기반 QueryFacade를 도입한 과정을 설명합니다.

기존 문제점

• Aggregator 패턴의 include 인자가 많아지고 유지보수 어려움
• 부분 에러 처리 미흡과 인자 명시성 부족
• 동시성 및 내결함성 관리의 복잡성 증가

GraphQL 도입 및 구현

• 맞춤 쿼리 작성, 동시성 지원, 부분 에러 처리, 의존성 명시가 가능함을 확인
• 커스텀 Directive를 이용한 에러 그룹핑과 캐시 제어 기능 구현
• EntityScalar를 활용해 필드 수에 의한 성능 이슈 개선
• Trusted Document로 쿼리 파싱 부하 감소

도입 성과

• 필요한 데이터만 쿼리하여 중복 코드 감소 및 유지보수 편의성 증가
• API 응답 속도 및 서버 비용 개선