Какие проблемы возникают, если endpoint объявлен async, а вся внутренняя логика остаётся синхронной?

Question

Если endpoint объявлен async, но внутри используются синхронные операции, сервер блокирует event loop. В результате приложение теряет преимущества асинхронности и плохо масштабируется. При высокой нагрузке такие эндпоинты начинают резко деградировать по времени ответа. Это частая ошибка при работе с БД или внешними сервисами.

YeaHub · Accepted Answer

ОпределениеАсинхронный endpoint — это обработчик запроса, который должен освобождать event loop во время ожидания ввода-вывода.В чём возникает проблемаАсинхронность работает только при одном условии — все длительные операции должны быть неблокирующими.Блокировка event loopсинхронный запрос к БДсинхронный HTTP-вызовтяжёлые вычисленияПотеря масштабируемостизапросы начинают выполняться последовательноколичество одновременных клиентов резко ограничиваетсяЛожное ощущение асинхронностикод выглядит современноно работает как обычный syncПример проблемы@app.get("/users")
async def get_users():
    users = sync_db_query()  # блокирует event loop
    return users
В этом случае:async не даёт преимуществприложение ведёт себя как синхронноеКак правильноиспользовать async-драйверывыносить sync-код в thread poolделать endpoint синхронным, если async не нуженВыводasync имеет смысл только тогда, когда вся цепочка операций поддерживает асинхронное выполнение.