피드로 돌아가기
Construí tu primera API con Fitz: un acortador de URLs con Postgres y auth en 30 minutos
Dev.toDev.to
Backend

외부 의존성 0개, 120라인으로 구현한 Native Binary API 설계

Construí tu primera API con Fitz: un acortador de URLs con Postgres y auth en 30 minutos

Martin Palopoli2026년 6월 9일15intermediate

Context

기존 Python 기반 API 스택은 FastAPI, Pydantic, SQLAlchemy, Alembic 등 다수의 외부 라이브러리 의존성으로 인해 빌드 아티팩트 크기가 커지고 관리 복잡도가 증가함. 특히 런타임 타입 체크로 인한 성능 오버헤드와 배포 시 복잡한 Dependency Management 문제가 병목 지점으로 작용함.

Technical Solution

  • AST 분석 기반의 OpenAPI 3.1 스키마 자동 생성으로 별도의 라우터 등록 과정 생략
  • 컴파일 타임 타입 체크를 통한 DB 쿼리 필드 검증으로 런타임 에러 원천 차단
  • @table 데코레이터와 DB 인트로스펙션을 결합한 Idempotent Migration 시스템 구축
  • 외부 런타임 없이 단일 Native Binary로 빌드하여 컨테이너 이미지 최적화 및 배포 단순화
  • spawn 메커니즘을 통한 Fire-and-forget 방식의 백그라운드 작업 처리 구조 설계
  • JWT 인증 및 Connection Pool 관리 기능을 런타임 내장하여 라이브러리 체인 제거

- 다수 라이브러리 조합으로 인한 Dependency Hell 발생 시 통합 런타임 도입 검토 - 런타임 타입 검증 비용이 높은 서비스의 경우 컴파일 타임 타입 체크 기반 언어/프레임워크 고려 - API 문서화 자동화를 위해 소스 코드의 AST를 직접 활용하는 도구 도입 검토 - 배포 파이프라인 단순화를 위해 Native Binary 빌드 전략 적용 가능성 확인

원문 읽기