크로키의 스택 - GraphQL

크로키닷컴이 Thrift 를 1년 쓴 뒤 GraphQL 로 API 를 옮긴 현황을 정리한 글이다. 전면 전환이 아니라 N+1 문제를 가진 기능 하나를 골라 검증한 뒤 넓혀 간 방식과, 스키마 정의 방법이 세 단계로 바뀐 과정을 담았다.

핵심 포인트

Thrift 를 1년 정도 쓰면서 여러 불편을 느껴 대안을 찾다 GraphQL 을 골랐다. 생태계가 Node.js 중심으로 발전하고 있어 크게 망설이지 않았다.
전환은 조심스럽게 했다. 외부에 영향을 주지 않으면서 N+1 문제를 가진 기능 하나를 먼저 바꿔 봤다.
검증 기준이 명확하다. 기존 API 대비 성능이 떨어지지 않으면서 사용은 더 편해지는지를 확인하고 나서 확대했다.
스키마 정의는 `GraphQLObjectType` → 스키마 문자열 → 데코레이터 기반 순으로 바뀌었다. resolver 구현에도 타입 체킹이 되고 DB 모델과 통일하기 위해서다.
다만 그 방식에 퍼포먼스 이슈가 있어 수정한 버전을 쓰고 있다고 밝힌다.

상세 정리