协程函数调用不执行,只返回coroutine对象:async def函数调用立即返回待调度的coroutine对象,需await或asyncio.run()执行;await用于挂起当前协程并解包结果,create_task实现并发;协程对象一次性,重复await报错。

协程函数调用不执行,只返回 coroutine 对象
这是 Python 的语法设计决定的:所有 async def 定义的函数,只要被调用(哪怕没带 await),就**立即返回一个 coroutine 对象**,而不是运行函数体、计算结果。它本质上是一个“待调度的执行单元”,不是值,也不是错误。
常见错误现象:
- 直接对返回值调用方法或访问属性 →
AttributeError: 'coroutine' object has no attribute 'xxx' - 把协程对象传给
json.dumps()或 HTTP 响应体 →TypeError: Object of type coroutine is not JSON serializable - 在非异步上下文中(如普通函数、
__init__、同步脚本顶层)调用后直接打印,看到的是<coroutine object ... at></coroutine>,误以为“没跑完”
必须用 await 才能拿到真实返回值
await 不是“让协程开始运行”的开关,而是“挂起当前协程、交出控制权、等待目标完成并解包结果”的操作。它只能在另一个协程函数内部使用。
实操要点:
立即学习“Python免费学习笔记(深入)”;
-
await后面必须是可等待对象(coroutine、Task、Future、实现了__await__的对象) - 不能在模块顶层、普通函数、
if分支外直接await—— 会报SyntaxError: 'await' outside async function - 想在同步环境里跑协程?得用
asyncio.run(<code>coro) 或asyncio.get_event_loop().run_until_complete(<code>coro),不能靠await
asyncio.create_task() 和 await 的行为差异
两者都处理协程对象,但语义和调度时机不同:
-
await coro:当前协程暂停,等coro完全执行完毕才继续;是串行等待 -
asyncio.create_task(coro):把coro包装成Task并立即加入事件循环排队;当前协程可继续执行其他逻辑(比如启动第二个任务) - 多个
create_task后再await它们,才能实现并发;单独await多个协程仍是串行
示例对比:
async def fetch(url): return f"done: {url}"
<h1>❌ 串行(总耗时 ≈ 2s)</h1><p>r1 = await fetch("a")
r2 = await fetch("b")</p><h1>✅ 并发(总耗时 ≈ 1s,假设每个 fetch 耗时 1s)</h1><p>t1 = asyncio.create_task(fetch("a"))
t2 = asyncio.create_task(fetch("b"))
r1 = await t1
r2 = await t2</p>为什么不能自动 await?——设计权衡
Python 没有在调用 async def 函数时自动 await,是因为:
- 协程对象本身可被传递、组合、延迟执行(比如作为参数传给
asyncio.wait()或asyncio.gather()) - 自动 await 会模糊“定义”和“执行”边界,破坏显式控制流,让调试和错误定位更难
- 事件循环需要明确知道哪些协程要调度;如果调用即执行,就无法做任务编排(如取消、超时、优先级)
真正容易被忽略的一点:协程对象是**一次性的**。一旦被 await 或 asyncio.run() 消费,再次 await 它会抛出 RuntimeError: cannot reuse already awaited coroutine。别把它当普通函数反复调用。


















