Python: asyncio.run cannot be called from a running event loop

#Что происходит и как распознать неисправность

RuntimeError: asyncio.run() cannot be called from a running event loop возникает, когда код пытается начать новый цикл asyncio внутри потока, где он уже запущен. Типичные места: Jupyter, асинхронные веб-обработчики, функции async def и тестовые среды.

#Как отличить причины

#Пошаговая диагностика и исправление

1. Определите, где именно вызван asyncio.runОткройте traceback в терминале или журнале, найдите последнюю строку вашего файла перед RuntimeError. В редакторе VS Code нажмите Ctrl+P, откройте указанный файл и найдите asyncio.run( через Ctrl+F. Если строка находится внутри async def, переходите сразу к изменению вызова на await.
2. Сохраните исходный фрагмент и проверьте контекстСкопируйте работающий файл в отдельную ветку Git либо сохраните его локальную копию. Найдите функцию, где встречается asyncio.run(...), и её объявление: async def или обычный def. Проверьте, вызывает ли библиотека этот код из веб-сервера/бота/Jupyter. Не пытайтесь отключить уже запущенный цикл ради одного вызова.
3. Замените вложенный запуск внутри async def на awaitКогда внешний код асинхронный, замените result = asyncio.run(fetch_data()) на result = await fetch_data(). Оставьте asyncio.run(main()) только на уровне запуска автономного скрипта под if __name__ == "__main__". Сохраните и запустите тестовый сценарий. Если после замены возникает SyntaxError: await outside function, вы редактируете синхронную функцию: пересмотрите границы async API.
4. В Jupyter используйте существующий циклЕсли ошибка появляется в ячейке Jupyter Notebook/Lab, удалите внешний вызов asyncio.run(...) и напишите непосредственно await main() на верхнем уровне ячейки. Запустите ячейку кнопкой Run. Ожидается результат корутины без создания второго цикла. Если среда не поддерживает верхнеуровневый await, проверьте её версию; не копируйте обходные monkey-patch из случайных статей.
5. Если функцию вызывают синхронные участки, разделите интерфейсСоздайте async def perform() для асинхронной работы и отдельную синхронную точку входа def main(): asyncio.run(perform()) только для команды запуска. Из уже работающего цикла используйте await perform(). Это исключает вложенность; не вызывайте синхронный main из асинхронного обработчика.
6. Проверьте исключения и незавершённые задачиПовторите прежний сценарий. Если вместо прежней ошибки появилось coroutine was never awaited, убедитесь, что вызов добавлен с await или намеренно запланирован как задача, которую затем ожидают. Если программа зависает, проверьте ожидание ввода/сети с таймаутами в коде, а не создавайте дополнительные event loop.
7. Верните исходный код, если изменилась логикаПроверьте возвращаемое значение, число выполненных запросов и отсутствие предупреждений. Если исправление нарушило API библиотеки, верните файл из сохранённой копии и подберите её нативный асинхронный метод. Зафиксируйте стек и версии Python/библиотеки.

#Команды и примеры для проверки

import asyncio

async def fetch_data():
    await asyncio.sleep(0.1)
    return "готово"

async def main():
    result = await fetch_data()
    print(result)

if __name__ == "__main__":
    asyncio.run(main())

#Как проверить результат и что делать дальше

Ошибка устранена, если тот же сценарий исполняется без RuntimeError и без предупреждения о неисполненной корутине. Внутри работающего event loop не вызывайте asyncio.run, а переключайтесь на await; в обычном самостоятельном скрипте оставляйте один запуск на верхнем уровне.