asyncio.run 报 RuntimeError:线程里已有事件循环怎么改

报错原文是 RuntimeError: aSYNcio.run() cannot be called from a running event loop,栈底那行落在 uvicorn 的 run_until_complete 上。Python 3.11 加 FastAPI,一个 async 端点里调了旧代码封装的同步函数,那个函数内部又用 asyncio.run 去拉起 httpx.AsyncCLIent。这段代码上线半年没动过,加了一条新路由才把它带出来。

第一反应是把 helper 改成 async def,调用处补 await,异常立刻消失。麻烦在同一份 helper 还有三个同步入口在用,改完之后同步侧拿到的是协程对象,日志里只留一句 coroutine was never awaited,接口返回 null,问题从报错变成了静默失败,查起来更费劲。

又试 asyncio.get_event_loop().run_until_complete,3.11 里直接提示当前线程没有事件循环。用 nest_asyncio 打补丁能跑通,但它改的是全局策略,和已经装上的 uvloop 一起在 import 阶段就崩,只能放弃。

最后按调用侧分流:async 分支直接 await,同步分支把协程丢进新开的循环里跑完再关掉,两条路共用同一个 AsyncClient 工厂,谁也不再调谁。判断只写一处,看调用方自己在不在循环里。

顺带确认一个边界,线程池 executor 里提交过去的协程同样不能 asyncio.run,那不是嵌套一层的问题,而是那个线程里根本没有循环。要跨线程就换成 run_coroutine_threadsafe,拿 future 回主线程等结果。

确认口径:200 并发压 10 分钟,接口 p99 从 180 毫秒回到 62 毫秒;日志里 coroutine was never awaited 计数为 0;再把同步入口的定时任务跑一遍,没有新增告警。

async def fetch(url):
    async with httpx.AsyncClient(timeout=5) as c:
        return (await c.get(url)).json()

def fetch_sync(url):
    # 同步侧自己开一轮循环 不要嵌进调用方
    return asyncio.run(fetch(url))

您可以还会对下面的文章感兴趣: