Async-сессии SQLAlchemy 2.x в FastAPI выглядят просто в туториалах, но на реальном трафике ломаются в неочевидных местах — от утечки соединений до implicit IO в lazy load. Разбираем механику проблем и способы их обойти.
Сервис на FastAPI начинает отвечать 502 и терять запросы при нескольких сотнях одновременных соединений. Разбираем, как связаны между собой event loop uvicorn, количество воркеров и пул соединений к базе — и где именно ломается каждое из звеньев.
Стандартного механизма пагинации в FastAPI нет, и каждая команда изобретает свой. Разбираем рабочую схему на основе зависимостей и дженериков Pydantic, которая подключается к любому роуту за три строки.
FastAPI не навязывает схему версионирования API. Это свобода, за которую платят ломающимися интеграциями у клиентов. Разбираем четыре подхода — от префикса в URL до заголовков — и показываем, чем каждый оборачивается на практике.
Когда эндпоинтов становится за сотню, автогенерированная документация FastAPI превращается из удобного инструмента в неуправляемую стену текстов. Разбираем, как вернуть ей читаемость: теги, роутеры, кастомизация OpenAPI-схемы и типичные ловушки.
Писать эндпоинты в FastAPI быстро, а вот покрывать их тестами — уже не так очевидно. Разберём, как устроен тестовый клиент, зачем подменять зависимости и почему тесты на реальной базе ломаются в CI чаще, чем в локальном терминале.
В FastAPI нет встроенной системы авторизации «из коробки» — фреймворк даёт примитивы, а собирать из них решение приходится самостоятельно. Разбираем четыре подхода: от простейшего API-ключа до OAuth2-провайдера, с конкретными фрагментами кода и таблицей, чтобы выбрать нужный за пять минут.
BackgroundTasks в FastAPI выглядят как простой способ отложить работу после ответа клиенту. На практике задачи теряются при перезапуске, блокируют event loop и молча падают без логов. Разбираем, как использовать встроенный механизм правильно и когда пора переходить на Celery или arq.
Приём файлов через API — задача, которая выглядит тривиально до первой утечки памяти на большом аплоаде. Разбираем рабочий эндпоинт на FastAPI 0.115.x: от простого UploadFile до потоковой записи, валидации и типичных ошибок.
FastAPI из коробки отдаёт 422 на невалидный запрос и 500 на необработанное исключение — и оба ответа часто бесполезны для клиента. Разбираем, как выстроить обработку ошибок так, чтобы фронтенд получал понятные сообщения, логи не превращались в кашу, а пользователь не видел трейсбек.
Middleware в FastAPI выглядит просто — декоратор, пара строк, и вот у вас логирование, CORS и замер времени. Но под нагрузкой промежуточный слой способен удвоить latency и создать проблемы, которые не видны на локальной машине. Разбираем реальный кейс: почему middleware на базе BaseHTTPMiddleware читал тело запроса дважды и как это починили без отказа от ASGI-стека.
Dependency Injection в FastAPI — не просто способ передать объект в эндпоинт. Разбираем приёмы, которые экономят код, и ошибки, которые превращают проект в неуправляемый клубок: вложенные цепочки, области жизни, тестируемость и реальную цену неправильного scope.