Vercel FastAPI, 정적 파일 CDN 자동 승격으로 Function 호출 제거

핵심 요약: Vercel이 FastAPI의 app.frontend()와 StaticFiles로 제공하는 프론트엔드·정적 파일을 빌드 시 CDN으로 자동 승격하도록 개선했습니다. 해당 경로 요청은 이제 Vercel Function을 호출하지 않고 CDN에서 바로 처리됩니다.

주요 변경

• app.frontend()와 StaticFiles의 정적 파일을 빌드 시 Vercel CDN으로 승격합니다.
• FastAPI의 라우트 선언 순서는 그대로 보존되어, 정적 파일 마운트보다 먼저 선언한 라우트가 우선합니다.
• dependency 또는 middleware 보호가 필요한 경로는 기본적으로 Function에 유지됩니다.
• pyproject.toml의 tool.vercel.fastapi.static 설정으로 정적 소스 제외 또는 CDN 승격 동작을 조정할 수 있습니다.

개발자 영향

FastAPI에서 프론트엔드와 정적 자산을 함께 제공하는 프로젝트는 별도 CDN 구성 없이 Function 호출을 줄이고 정적 파일 응답 경로를 단순화할 수 있습니다. 다만 인증·dependency·middleware가 적용된 정적 경로는 CDN에서 해당 검사를 실행할 수 없으므로 기본 동작과 강제 승격 설정을 구분해 적용해야 합니다.

발표 시각(KST): 2026년 9월 10일 (Vercel 공식 원문에 세부 시각 미표기)

원문 출처 보기 →