FastAPI 프론트엔드와 CDN에서 제공하는 정적 파일

Vercel이 FastAPI 애플리케이션의 프론트엔드와 정적 파일(app.frontend() 또는 StaticFiles)을 빌드 시점에 CDN으로 승격하여 서빙하는 기능을 도입했다. 이제 해당 경로에 대한 요청은 Vercel Function을 호출하지 않고 CDN에서 직접 처리된다.

라우팅 우선순위 및 예외 처리

FastAPI는 라우트를 선언된 순서대로 평가하므로, StaticFiles 마운트보다 먼저 선언된 라우트는 해당 경로의 CDN 파일보다 우선한다. 이 우선순위는 유지된다.

원본 소스 디렉터리는 런타임에 앱이 읽을 수 있도록 함수 번들에 남지만, pyproject.toml에서 tool.vercel.fastapi.static.exclude = true를 설정하면 제외하고 CDN에서만 서빙할 수 있다.

의존성 및 미들웨어 처리

CDN은 의존성 검사를 수행할 수 없으므로, 의존성에 의해 보호되는 프론트엔드는 함수에 유지된다. 미들웨어 뒤에 있는 정적 파일도 동일하게 함수에 남는다. tool.vercel.fastapi.static.cdn = true로 설정하면 이를 무시하고 항상 CDN으로 승격할 수 있으며, false로 설정하면 CDN 사용을 완전히 해제할 수 있다.