协程迭代陷阱，别在迭代中用协程

在Go语言中协程（goroutine）与Python异步生态常被混淆，但本文实际聚焦Python的异步迭代陷阱：普通for循环无法直接await协程，因其底层依赖同步的iter()/next()协议，而协程必须通过await或专用语法才能执行；常见错误如将协程列表逐个await导致串行阻塞、误用同步for遍历异步生成器引发TypeError，实则应根据场景选用async for（针对真正实现__aiter__/__anext__的异步迭代器）或asyncio.gather()（并发执行多个协程），否则不仅代码崩溃，更会彻底丧失异步并发性能优势——理解同步与异步迭代协议的根本隔离，是写出正确高效Python异步代码的关键起点。

不能在普通 for 循环中直接 await 协程，因为 for 本身不支持 awaitable 迭代 —— 它只消费同步迭代器，不是异步迭代器。

为什么 for item in async_iter: 会报错

Python 的 for 语句底层调用的是 iter() 和 next()，这两个都是同步函数。如果你传入一个返回 awaitable 的对象（比如协程函数调用结果、或未被 async for 包裹的异步生成器），for 会尝试对它调用 next()，结果得到一个协程对象而非实际值，接着抛出 TypeError: 'coroutine' object is not iterable 或类似错误。

• 常见错误现象：TypeError: 'coroutine' object is not iterable、RuntimeWarning: coroutine 'xxx' was never awaited
• 典型误写：for coro in [fetch_data(url) for url in urls]: result = await coro —— 这里 fetch_data(url) 返回协程，但 for 并不 await 它
• 真正想做的其实是并发执行多个协程，而不是“迭代协程”，这时该用 asyncio.gather() 或 asyncio.create_task()

async for 才是合法的异步迭代语法

async for 是 Python 3.6+ 专为异步迭代器设计的语法糖，它要求目标对象实现 __aiter__() 和 __anext__() 方法（即异步迭代器协议）。普通生成器、列表、map 等都不满足这个协议。

• 能用 async for 的对象：异步生成器（含 async def + yield）、实现了 __aiter__/__anext__ 的类实例
• 不能用 async for 的对象：range(10)、[1,2,3]、map(lambda x: x*2, data)、普通 def 函数返回的生成器
• 示例对比：

  async def a_range(n):<br>    for i in range(n):<br>        await asyncio.sleep(0.1)<br>        yield i<br><br>async for x in a_range(3):  # ✅ 正确：异步生成器<br>    print(x)<br><br>for x in range(3):           # ✅ 正确：同步迭代<br>    print(x)<br><br>for x in a_range(3):       # ❌ 错误：a_range(3) 返回 AsyncGenerator，不可被同步 for 消费

把协程塞进列表再 for 循环，等于放弃并发优势

很多人写 coros = [fetch(url) for url in urls]; for c in coros: await c，这看似“在迭代协程”，实则是串行等待 —— 每个 await 都阻塞后续协程启动，完全失去异步意义。

• 性能影响：总耗时 ≈ 所有请求耗时之和，而非最大值
• 正确做法：results = await asyncio.gather(*coros) 或逐个 create_task 后 await
• 兼容性注意：asyncio.gather 在 Python 3.7+ 默认保留顺序；若需取消某任务，应改用 asyncio.create_task + asyncio.wait

迭代器和协程的协议根本不兼容

同步迭代器靠 next() 抛 StopIteration 结束；异步迭代器靠 anext() 抛 StopAsyncIteration 结束。两者协议隔离，没有隐式转换机制 —— 就像不能把 int 当 str 直接用，Python 不会帮你自动 await 一个协程来取值。

• 容易踩的坑：以为 list(coroutine_generator) 能“展开”协程，结果得到一串未 await 的协程对象列表
• 调试技巧：打印 type(obj) 和 hasattr(obj, '__aiter__') 可快速判断是否为合法异步可迭代对象
• 最常被忽略的一点：即便你写了 async def，如果没用 yield，它就只是协程函数，不是异步迭代器；只有含 yield 的 async def 才是异步生成器

今天关于《协程迭代陷阱，别在迭代中用协程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！