GitBook, 1초 미만의 콘텐츠 업데이트로 3만 개의 사이트를 운영하는 방법

GitBook은 Vercel을 통해 3만 개의 문서 사이트를 호스팅하며, 매월 1억 2천만 회의 페이지 뷰를 처리하고 있다. n8n, Nvidia, Zoom과 같은 기업들이 이 플랫폼을 통해 빠르고 정확한 문서를 제공받는다.

기존에는 콘텐츠 수정 후 반영까지 지연이 발생하는 문제가 있었다. GitBook은 Next.js와 Vercel의 use cache 지시어를 도입하여, 전체 페이지가 아닌 개별 데이터 페칭 함수 단위로 캐싱함으로써 API 호출 중복을 방지하고 효율성을 높였다.

멀티테넌트 환경에서의 캐시 무효화 문제를 해결하기 위해 태그 기반 무효화(tag-based invalidation) 방식을 구축했다. Git이나 GitLab의 머지(merge) 이벤트가 발생하면 해당 콘텐츠 태그만 즉시 재검증(revalidation)하여, 다른 사이트에 영향을 주지 않고도 300ms 이내에 업데이트를 반영한다.

특히 전체 트래픽의 **41%**가 AI 크롤러와 자동화 시스템에서 발생하고 있다. AI는 인간보다 훨씬 예측 불가능한 방식으로 방대한 페이지를 훑기 때문에, 높은 캐시 적중률(cache hit rate)을 유지하는 것이 인프라 비용과 성능 관리의 핵심 과제가 되었다.