Flask-приложение выросло, и вы решили переехать на FastAPI ради асинхронности и автодокументации. Разбираем реальные отличия в роутинге, DI, валидации и работе с базой — и показываем, чем за это придётся заплатить.
У Flask больше двух тысяч расширений на PyPI, и новичок ставит их пачками «на всякий случай». Разбираем на примере типичного API-сервиса, какие расширения решают реальные задачи, какие дублируют друг друга, и чем вы платите за каждое лишнее.
Blueprints в Flask обещают модульность, но на практике приводят к циклическим импортам, потерянным шаблонам и нечитаемой фабрике приложения. Разбираем пять конкретных ошибок — с кодом, который их воспроизводит, и кодом, который их исправляет.
Когда в проекте на FastAPI десятки эндпоинтов, три базы данных и пять микросервисов-потребителей, плоская структура из одного main.py превращается в кошмар при ревью и деплое. Разбираем подходы к организации кода, которые выдерживают рост команды и кодовой базы.
Пагинация через offset/limit кажется простой до момента, когда таблица вырастает до миллиона строк и каждый запрос начинает ходить по индексу с начала. Разбираем типичные ошибки в фильтрации и пагинации FastAPI-сервисов и собираем чек-лист, с которым эндпоинт не развалится под нагрузкой.
FastAPI даёт как минимум семь способов вернуть ошибку клиенту, но если не договориться о формате заранее, фронтенд получит то JSON с полем detail, то голый текст, то HTML-страницу от Uvicorn. Разбираем каждый способ, сравниваем и выбираем тот, который не развалится, когда API вырастет.
Alembic в связке с FastAPI и SQLAlchemy решает задачу миграций, но на практике ломается на autogenerate, ветвлениях и данных. Разбираем приёмы, которые спасают от типичных проблем в реальных проектах.
Сессия SQLAlchemy в FastAPI — объект с неочевидным жизненным циклом. Неправильное управление приводит к утечкам соединений, грязным чтениям и ошибкам под нагрузкой. Разбираем, как устроена сессия изнутри, когда она должна закрываться и почему middleware — не всегда подходящий выбор.
TestClient из Starlette позволяет тестировать эндпоинты FastAPI без запуска сервера. Разбираем рабочие приёмы: от простых GET-запросов до подмены зависимостей и тестирования WebSocket, с конкретными примерами и типичными граблями.
Как реализовать аутентификацию по OAuth2 с JWT-токенами в FastAPI — от хеширования паролей до защиты эндпоинтов. Рабочий код, который можно запустить и адаптировать под свой проект.
BackgroundTasks в FastAPI выглядит просто — передал функцию, она выполнится после ответа. На практике задачи теряются при перезапуске, блокируют event loop и молча падают без логов. Разбираем четыре частых ошибки и подходы, которые их закрывают.
Механизм Depends в FastAPI — это не просто способ передать объект в обработчик. Разбираем рабочие приёмы: вложенные зависимости, кеширование, области жизни, переопределение в тестах и типичные ошибки, из-за которых запросы начинают тормозить или молча ломаться.