단일 노드 2,000+ ops/s 달성한 Go 기반 고성능 PDF 엔진 설계 분석

Context

기존의 단순 라이브러리 래퍼 구조로는 PDF/A-4 및 PDF/UA-2 표준 준수와 금융권의 대량 문서 생성 요구사항을 충족하기 어려움. 특히 메모리 할당 오버헤드와 ISO 32000 규격의 복잡성으로 인한 시스템 성능 병목 해결이 필수적인 상황임.

Technical Solution

• 메모리 할당 최적화를 위해 페이지당 64KiB로 사전 확장된 pooled bytes.Buffer를 도입하여 GC 부하 감소
• zlib.NewWriter의 256KB 압축 테이블 생성 비용을 줄이기 위해 전역 압축 풀(Central pools) 기반의 스트림 처리 구현
• PDF 구조를 텍스트 파일이 아닌 Byte-offset Graph로 정의하여 객체 경계 탐지 및 효율적인 xref-stream 파싱 수행
• 렌더링 시 내부적으로는 Top-down Y 모델을 사용하고 출력 시 Flip Matrix를 적용하는 좌표계 변환 계층 설계
• 폰트 서브셋팅 시 Global Graph 대신 Per-PDF Font Registry Clone 방식을 채택하여 객체 간 의존성 격리 및 무결성 확보
• 전체 그래프를 메모리에 보유한 후 finalize 단계에서 한 번에 직렬화하는 In-memory Graph Building 전략으로 처리량 극대화

Impact

• 48개 워커 기준 피크 처리량 ~2,061 ops/s 달성
• 2,000행 규모의 PDF/A 생성 시 단일 연산당 31~36ms 소요
• 최적화 패스를 통해 처리량(Throughput) 197% 향상