Статика FastAPI на Vercel уходит на CDN при сборке — функция не вызывается

Vercel при сборке продвигает на CDN фронты FastAPI через app.frontend() и каталоги со StaticFiles. Запросы к этим путям идут напрямую с edge — serverless-функция на стили и скрипты больше не вызывается.

Порядок роутов FastAPI не изменился: маршрут, объявленный раньше mount StaticFiles, перебивает файл на CDN по тому же пути. Продвинутые каталоги всё равно остаются в бандле функции — приложение может читать из них в рантайме.

Когда статика остаётся на функции

Не всё уезжает на CDN автоматически. Фронты под dependency guards остаются на функции: CDN не умеет проверять зависимости. То же с файлами за middleware — пока проверка живёт в приложении, отдача идёт через Vercel Function.

Настройки в pyproject.toml

• tool.vercel.fastapi.static.exclude = true — убрать продвинутые каталоги из бандла функции и отдавать только с CDN
• tool.vercel.fastapi.static.cdn = true — принудительно продвигать на CDN, даже если статика за middleware или dependency
• tool.vercel.fastapi.static.cdn = false — полный отказ от CDN для статики

Источник: FastAPI frontends and static files served from the CDN.