asyncio.run()不能在已有事件循环中调用，应在顶层使用；已有loop时改用await；避免协程未await、跨线程误用loop及第三方库隐式loop冲突。
RuntimeError: asyncio.run() cannot be called from a running event loop
这是最常遇到的异步 RuntimeError，本质是嵌套调用 asyncio.run()。你在 Jupyter、Django shell、FastAPI 的依赖函数、或已处于事件循环中（比如 asyncio.create_task() 启动的协程里）又调了 asyncio.run()，Python 就会直接报错。
解决办法不是“加 try-except”，而是改掉调用方式：
- 如果在已有 event loop 的环境里（如 Jupyter），改用
await直接执行协程对象，而不是包装成asyncio.run(coro) - 如果必须从同步代码启动异步逻辑（比如 CLI 工具入口），确保只在顶层（模块级、
if __name__ == "__main__":块内）调用asyncio.run() - 检查是否误把协程函数当普通函数调用了——比如写了
my_coro()却没加await，这会返回一个协程对象，后续传给asyncio.run()就可能触发嵌套检测
协程未 await 导致的 RuntimeError 或静默失败
Python 3.12+ 对未 await 的协程对象会发出 RuntimeWarning: coroutine 'xxx' was never awaited；某些旧版本或特定上下文（如 pytest 异步测试）则可能升级为 RuntimeError。这不是语法错误，但会导致逻辑跳过、资源泄漏或超时失败。
关键判断点：你看到的 “coroutine object at 0x…” 不是结果，是待执行的计划。
立即学习“Python免费学习笔记（深入）”；
- 用
isinstance(obj, asyncio.Coroutine)快速检查变量是不是协程对象（注意：asyncio.Task和asyncio.Future不是Coroutine，但也要 await） - 在日志或调试中打印
type(my_call())，如果是<class 'coroutine'>，就必须await - 避免在
for循环里直接调用协程函数却不 await：[fetch(url) for url in urls]生成的是协程对象列表，不是结果列表；应改用await asyncio.gather(*[fetch(u) for u in urls])
多线程中误用 asyncio.run() 或 loop
asyncio 的 event loop 是线程绑定的。你在子线程里直接调 asyncio.run() 通常能跑通，但若主线程已有 loop（比如 Flask + gevent 场景），或你手动调了 asyncio.get_event_loop() 再 .run_until_complete()，就容易触发 RuntimeError: There is no current event loop in thread 'XXX'。
跨线程调度异步任务，不要试图“共享 loop”：
- 子线程中一律用
asyncio.run()启动全新 loop（它内部会自动set_event_loop） - 避免在子线程里调
asyncio.get_event_loop()—— 它不保证返回当前线程的 loop，尤其在 Python 3.12+ 默认行为已变更 - 如果必须从线程安全地交由主线程 loop 执行（例如 GUI 更新），用
asyncio.run_coroutine_threadsafe(coro, loop)，并确保loop是主线程创建且正在运行的
第三方库触发的隐式 loop 冲突（如 httpx、aiomysql）
有些库（如旧版 httpx.AsyncClient）在实例化时会偷偷访问当前 loop，如果此时没有可用 loop（比如刚启动的线程），就会报 RuntimeError: no running event loop；另一些（如某些版本的 aiomysql）会在 __init__ 里调 get_event_loop()，导致和 asyncio.run() 冲突。
这类问题难定位，因为堆栈里看不到你写的 asyncio.run()：
- 先确认库版本：httpx ≥ 0.24 要求显式传
transport或确保 loop 存在；aiomysql ≥ 0.3.0 改用create_pool()替代构造函数初始化 - 统一用
async with管理客户端生命周期，别在__init__或模块级创建全局 client 实例 - 在入口处显式启动 loop 并保持引用（比如
loop = asyncio.new_event_loop()），再用asyncio.set_event_loop(loop)，之后所有该线程的get_event_loop()才有落脚点
真正棘手的从来不是报错信息本身，而是那个没被 await 的协程、那个被忽略的线程上下文、或者第三方库文档里没写明的 loop 绑定前提。留心 coroutine 类型、检查线程归属、查清库的初始化时机——这些比记住错误码管用得多。
