Python / 系统课时

协程对象为什么不会自动运行

协程对象为什么不会自动运行

调用普通函数时,函数体会立刻执行;调用 async def 定义的函数时却只得到一个协程对象。本篇把函数、协程对象、Task 与事件循环分开来看,并用可运行代码验证“创建协程”和“执行协程”其实是两件事。

学习目标

  • 区分普通函数、协程函数和协程对象
  • 解释调用 async 函数后为什么函数体还没有执行
  • 判断 await、asyncio.run() 与 Task 各自在什么时候推动协程运行

调用 async 函数时发生了什么

def 定义普通函数,调用后会直接进入函数体并返回结果。async def 定义的是协程函数,调用它时 Python 先创建一个协程对象,函数体不会因为这次调用自动向前执行。

下面的示例把两个过程放在一起观察:

python
import asyncio

# 普通函数调用后立即执行函数体。
def normal_work():
    print("normal: body")
    return "N"

# async 函数调用时先返回协程对象,函数体稍后由事件循环驱动。
async def async_work():
    print("async: body")
    return "A"

print("1: call normal")
normal_result = normal_work()

print("2: call async")
coro = async_work()
print(f"3: object type = {type(coro).__name__}")

print("4: start event loop")
async_result = asyncio.run(coro)
print(f"5: result = {async_result}")

预期输出

text
1: call normal
normal: body
2: call async
3: object type = coroutine
4: start event loop
async: body
5: result = A

关键观察是:async_work() 在第 2 步已经被调用,但 async: body 直到 asyncio.run(coro) 启动事件循环并驱动这个协程时才出现。协程对象更像“尚未执行完的异步计算描述”,而不是已经在后台运行的线程。

协程对象不是后台任务

协程对象只保存一次协程调用的执行状态。单独把它赋给变量、放进列表或作为参数传递,都不会让代码自动执行。若程序结束时某个协程对象从未被等待,Python 还可能发出 coroutine was never awaited 警告。

Task 则不同。运行中的事件循环可以用 asyncio.create_task() 把协程包装成 Task,并把它登记为待调度工作。Task 仍然不是新线程;它只是让事件循环知道“这个协程需要在合适的时机继续运行”。

对象 创建后是否自动进入调度 典型产生方式
协程对象 否 调用 async def 函数
Task 是,在当前事件循环中排队 asyncio.create_task(coro)
普通返回值 已由同步调用得到 调用普通函数

谁让协程真正向前执行

一个协程要执行,必须有人持续调用它的异步协议并在挂起后再次恢复它。日常代码里,这个角色通常由事件循环和 Task 完成;最外层则常通过 asyncio.run() 建立事件循环并运行入口协程。

协程函数、协程对象与事件循环的调度关系

这也解释了为什么“调用异步函数”和“启动并发任务”不能混为一谈。前者只是构造协程对象;只有 await、asyncio.run()、Task 等调度机制介入后,协程才会获得执行机会。

容易混淆的边界

await coro 会在当前协程中等待另一个协程完成,属于结构化的依赖关系;asyncio.create_task(coro) 则把它注册成可独立推进的 Task,适合需要与当前协程交错执行的工作。

同一个协程对象只能被完整消费一次,不应反复 await。如果一段异步逻辑需要多处等待同一份结果,通常应先创建 Task,再让多个等待者等待这个 Task。判断代码是否“已经开始跑”的关键,不是有没有调用 async 函数,而是这个协程是否已经交给事件循环驱动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

协程对象为什么不会自动运行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通