できない.dev

Python asyncio「RuntimeError: Event loop is closed」の原因と直し方

RuntimeError: Event loop is closed は、loop.close() を自前で呼ばず asyncio.run() に任せれば直る。
Windows + aiohttp ではセレクタ系のループに切り替える。

公開: 更新:

症状できない · exit 1
python bad.py
…
Traceback (most recent call last):
  File "/tmp/tmp.y2ZCN04DZc/bad.py", line 12, in <module>
    print(loop.run_until_complete(work()))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
解決後できた · exit 0
python good.py
1回目: done
2回目: done

2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細

要約

RuntimeError: Event loop is closed は asyncio のイベントループを閉じた後にコルーチンやコールバックが走ろうとした際の例外だ。
多くは Windows + aiohttp の組み合わせ、もしくは loop.close() を自前で呼んだケースで再現する。
asyncio.run() に任せ、Windows では SelectorEventLoop で動かすのが定番の対処だ。

実行例

実際に上記のコードを python:3.12 環境で動かすと、閉じたループへの run_until_complete 呼び出しが RuntimeError: Event loop is closed を送出し、終了コード 1 で終了した。
asyncio.run() に統一すると、2 回目も正常に完了した(終了コード 0)。

$ python --version
Python 3.12.13
$ python bad.py
1回目: done
2回目(閉じたループを再利用):
Traceback (most recent call last):
  File "/tmp/tmp.y2ZCN04DZc/bad.py", line 12, in <module>
    print(loop.run_until_complete(work()))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/asyncio/base_events.py", line 666, in run_until_complete
    self._check_closed()
  File "/usr/local/lib/python3.12/asyncio/base_events.py", line 545, in _check_closed
    raise RuntimeError('Event loop is closed')
RuntimeError: Event loop is closed
sys:1: RuntimeWarning: coroutine 'work' was never awaited
$ echo $?
1
$ python good.py
1回目: done
2回目: done
$ echo $?
0

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
python:3.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. Windows ではセレクタ系のループに切り替える

aiohttp の既知の問題(新しいタブで開く)の回避策である。
Python 3.12 以降は asyncio.run() の loop_factory でループを指定する(公式ドキュメント(新しいタブで開く))。

import asyncio
import sys
 
loop_factory = asyncio.SelectorEventLoop if sys.platform == "win32" else None
asyncio.run(main(), loop_factory=loop_factory)

3.11 以前は asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy()) で切り替える。
この関数とクラスは 3.14 で非推奨になり、3.16 で削除される予定である(公式ドキュメント(新しいタブで開く))。

2. ループを自前で閉じない

loop = asyncio.new_event_loop()
loop.run_until_complete(main())
loop.close()
loop.run_until_complete(other())  # RuntimeError: Event loop is closed

閉じたループは再利用できない。
loop.close() を 2 回呼ぶだけ、閉じたあとに asyncio.run() を呼ぶだけならエラーにならない(Python 3.12 で確認)。
ループを自前で持たず、asyncio.run だけに統一する。

asyncio.run(main())
asyncio.run(other())

3. 残タスクを掃除してから終了する

async def main():
    await do_work()
    pending = [t for t in asyncio.all_tasks() if t is not asyncio.current_task()]
    for t in pending:
        t.cancel()
    await asyncio.gather(*pending, return_exceptions=True)
 
asyncio.run(main())

4. Jupyter / IPython では asyncio.run を使わない

Jupyter のセルでは既にイベントループが回っているため、asyncio.run() は失敗する。
トップレベルで await main() と書くか、どうしても asyncio.run() を使いたければ nest_asyncio.apply() で入れ子を許可する。

よくある原因

  1. Windows + Python 3.8 以降のデフォルト ProactorEventLoop と、aiohttp の SSL クローズ処理が組み合わさっている
  2. loop.close() や asyncio.run() で閉じたループに、もう一度 run_until_complete() を呼んでいる
  3. プログラム終了直前に SSL transport などのファイナライザが、クローズ済みループへコールバックを登録しようとする(__del__ → close() → call_soon() の順に呼ばれる)
  4. Jupyter Notebook 内で asyncio.run() を呼び、既存ループと衝突している