调用 async 函数返回协程对象,需 await 或事件循环驱动才执行;await 触发挂起、注册恢复、交还控制权;asyncio.run() 新建并管理事件循环;同步阻塞操作会卡死整个异步程序。

async 函数调用后到底发生了什么
调用 async def 定义的函数,不会立即执行函数体,而是返回一个 coroutine 对象。这个对象本身是惰性的,必须被事件循环驱动或显式 await 才会运行。
- 直接打印
my_coro()的结果,看到的是类似的字符串,不是返回值 - 在同步上下文中(比如普通函数里)直接调用却忘了 await,程序不会报错,但你拿到的永远是未执行的协程对象,后续逻辑大概率出 bug
- 在模块顶层或 Jupyter 中尝试
await my_coro()会报SyntaxError: 'await' outside async function—— await 只能在async def函数内部或交互式环境(如 IPython、Python 3.12+ 的-i模式)中使用
await 表达式触发的三步实际动作
await 不是“等待完成”,而是“让出控制权 + 注册恢复点 + 等待可恢复”。它背后涉及事件循环调度、状态机切换和挂起/恢复机制。
- 执行到
await expr时,Python 检查expr是否实现了__await__方法(即是否是 awaitable);如果不是(比如传了普通整数),抛出TypeError: object int can't be used in 'await' expression - 如果
expr是协程、Task或实现了__await__的对象(如asyncio.sleep()),当前协程会被挂起,控制权交还给事件循环 - 事件循环继续轮询其他就绪任务;当被 await 的对象“准备好”(例如 sleep 时间到、IO 数据到达),事件循环将该协程标记为可恢复,并在下一轮调度中 resume 执行
await后面的代码
asyncio.run() 内部到底做了什么
asyncio.run(main()) 是最常用的入口,但它不是简单地“运行协程”。它封装了完整的事件循环生命周期管理。
- 每次调用
asyncio.run()都会新建一个事件循环(asyncio.new_event_loop()),并设置为当前线程的默认循环 - 它把
main()包装成Task并启动循环;一旦main()返回或 raise 未捕获异常,自动调用loop.close() - 不能在已有运行中的事件循环内调用
asyncio.run(),否则报RuntimeError: asyncio.run() cannot be called from a running event loop - 若需嵌套或复用循环(如在已运行的
asyncio服务中临时跑一个协程),应改用asyncio.create_task()或asyncio.ensure_future()
常见阻塞陷阱:哪些操作会让 async 代码变慢甚至卡死
async/await 本身不提供并发,只是协作式并发的基础;任何同步阻塞调用都会拖垮整个事件循环。
这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园,随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界,David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)
立即学习“Python免费学习笔记(深入)”;
-
time.sleep(2)是典型反例 —— 它会阻塞整个线程,所有协程都停摆;必须换成await asyncio.sleep(2) - 同步数据库驱动(如
sqlite3、pymysql默认模式)、requests、正则大量匹配、CPU 密集型计算,都会破坏异步性;应使用异步替代品(aiosqlite、aiohttp、asyncio.to_thread()或loop.run_in_executor()) - 忘记加
await在协程调用上(如写成fetch_data()而非await fetch_data()),会导致该协程永远不会执行,但也不会报错 —— 这是最隐蔽的 bug 来源之一
真正理解 async/await 的关键,不是记住语法,而是清楚每一处 await 在哪一刻让出了控制权、谁在何时把它捡起来、以及中间有没有别的协程趁机跑了好几轮。事件循环看不见,但它的节奏决定了整个 async 程序的呼吸频率。









