Python异步程序如何用asyncio.run启动与关闭事件循环

asyncio.run() 虽是 Python 3.7+ 推荐的异步程序启动方式，却远非“万能钥匙”：它仅适用于无运行中事件循环的简单脚本，一旦在 Jupyter、Web 框架 shell 或已手动创建 loop 的环境中调用，便会触发 RuntimeError；更关键的是，它强制新建并关闭事件循环，导致后台任务无声取消、全局异步资源（如未 await 的 aiohttp session）失效，且不支持自定义策略、复用循环或嵌入长期运行环境——真正决定程序健壮性的，不是如何启动异步主函数，而是谁来接管循环生命周期、何时优雅关闭、以及关之前是否彻底清理了所有 pending 任务与资源。

asyncio.run() 是不是万能的主入口

绝大多数简单脚本用 asyncio.run() 没问题，但它只在“没有运行中的事件循环”时才安全。一旦你在 Jupyter、Django shell、或已手动调用 asyncio.new_event_loop() 的环境里再调用它，就会报 RuntimeError: asyncio.run() cannot be called from a running event loop。

常见踩坑场景：

• Jupyter Notebook 里反复执行 asyncio.run() 单元格（第二次就崩）
• Flask 或 FastAPI 的同步路由里直接调异步函数并用 run() 包裹
• 测试代码中多个 asyncio.run() 调用没做隔离，导致循环被重复关闭又重建

为什么 asyncio.run() 会自动关闭 EventLoop

它内部做了三件事：新建 loop → 调用你的协程 → 调用 loop.close()。这个关闭是强制的，哪怕协程里 spawn 了后台任务（比如 asyncio.create_task()），只要主协程返回，loop 就关，后台任务直接被 cancel。

所以别指望靠 asyncio.run() 做长时后台服务——它不是设计来托管长期运行的事件循环的。

• 后台任务没 await 完就被 kill，不会抛异常，但你会看到 Task was destroyed but it is pending! 警告
• 如果协程里用了 async with aiohttp.ClientSession()，session 会在 loop 关闭前被正确退出；但如果 session 被存成全局变量，下次再用就失效
• asyncio.run() 不接受 debug=True 以外的 loop 参数，没法传自定义策略或已配置好的 loop

什么时候该换掉 asyncio.run()

当你需要控制生命周期、复用 loop、或嵌入已有运行环境时，就得绕过 asyncio.run()。

• 在主线程已有 loop（如 PyQt/TKinter 的异步集成），改用 asyncio.get_event_loop().run_until_complete()
• 想让多个协程共享同一个 loop（比如同时跑 HTTP client 和 WebSocket server），手动创建并保持 loop 实例
• 写 CLI 工具且需支持子命令异步执行，避免每次子命令都新建+关闭 loop，影响性能和资源清理
• 使用 trio 或 curio 等替代库时，asyncio.run() 根本不适用

一个安全的手动 loop 启动模板

如果你必须自己管理 loop（比如兼容 Python 3.6 或规避 run() 的限制），下面是最简可行写法：

import asyncio

loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
try:
    loop.run_until_complete(main())
finally:
    loop.close()

注意两点：

• Python ≥ 3.7 推荐用 asyncio.run()，除非你明确知道为什么不用
• loop.close() 后不能再用这个 loop，也不能再调 set_event_loop() 绑定已关闭的 loop
• Windows 上默认策略是 ProactorEventLoop，某些低层操作（如 subprocess）可能要求切换回 SelectorEventLoop

真正麻烦的从来不是怎么启，而是启完之后谁负责关、什么时候关、关之前有没有漏掉 await 的 cleanup —— 这些细节藏在业务逻辑深处，而不是 API 文档第一行。

终于介绍完啦！小伙伴们，这篇关于《Python异步程序如何用asyncio.run启动与关闭事件循环》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！