1,200개 API 규모에서 도출한 OpenAPI Codegen 효율성 분석

Context

수동 API 클라이언트 작성에 따른 유지보수 비용 증가와 런타임 타입 안정성 확보 필요성 증대. 대규모 OpenAPI 스키마(75,000라인) 적용 시 생성 파일 수와 IDE 인덱싱 성능이 개발 생산성의 병목 지점으로 작용.

Technical Solution

• 요구사항에 따른 Codegen 계층 분리: 단순 Type 정의, SDK 기반 함수 호출, 프론트엔드 에셋 자동 생성으로 구분하여 도구 선정
• openapi-typescript: 단일 파일 기반의 Type 전용 생성으로 I/O 최소화 및 최단 생성 속도 확보
• hey-api: operationId 기반 SDK 함수와 Interceptor를 도입하여 URL 문자열 의존성 제거 및 인증 로직 중앙화
• Orval: TanStack Query, Zod, MSW 등 외부 라이브러리 통합 생성을 통한 프론트엔드 인프라 자동화
• Kubb: '1 Operation = 1 File' 원칙의 플러그인 아키텍처를 통한 Tree-shaking 최적화 및 생성 파이프라인 제어