Python异步编程陷阱：避免阻塞I/O操作

Python异步编程看似只需添加async/await，实则暗藏多重陷阱：在async函数中误用time.sleep()、requests等同步阻塞操作会冻结整个事件循环；漏写await导致协程对象意外传递、引发运行时错误；async for/with语法只能存在于async函数内，强行混用将直接触发语法错误；而反复调用asyncio.run()则会因事件循环关闭而崩溃。真正高效的异步并非语法修饰，而是确保I/O全链路异步化——从HTTP请求、数据库访问到文件读写，每一环都需选用原生异步库或通过线程池安全桥接，否则表面异步、实则退化为单线程阻塞。

async函数里调用time.sleep()会卡住整个事件循环

这是最典型也最容易犯的错误：把同步阻塞操作直接塞进async函数。比如用time.sleep(1)代替await asyncio.sleep(1)，结果是当前协程不交出控制权，其他任务全被挂起——表面上写了async，实际还是单线程阻塞。

• time.sleep()、input()、requests.get()、文件读写（如open().read()）都不能在async函数中直接用
• 替代方案必须是真正支持异步的：用await asyncio.sleep()代替time.sleep()，用aiohttp代替requests，用aiosqlite或asyncpg代替sqlite3/psycopg2
• 如果真要调用无法异步化的第三方库（比如某些科学计算函数），得用loop.run_in_executor()扔到线程池里跑，否则就破功

忘记await导致返回coroutine对象而非结果

Python不会自动await一个协程对象。漏写await时，函数不报错，但返回的是，下游代码拿到这个对象后继续用（比如想取.json()），就会抛AttributeError。

• 常见于链式调用：data = fetch_user() # 忘了await → data是coroutine，不是dict
• 调试时可以加一句assert not asyncio.iscoroutine(data)快速暴露问题
• IDE（如PyCharm）和类型检查器（如mypy配合asyncio插件）能标出这类漏await，但运行时不会拦

async for和async with不能用在普通函数里

这两个语法糖只在async def函数内部有效。如果在同步函数里写async for item in reader:，Python直接报SyntaxError: 'async for' outside async function；同理，async with也会触发类似错误。

• 不是“加个await就能修”，而是整个外层函数必须声明为async def
• 这意味着调用链上游也得是async——不能在if __name__ == '__main__':下面直接写async for，得包在async def main():里，再用asyncio.run(main())启动
• 某些老项目混用同步/异步模块时，容易在边界处漏改函数定义，结果卡在语法报错上

用asyncio.run()多次调用会报RuntimeError: Event loop is closed

asyncio.run()设计为“一次性入口”：它新建事件循环、运行协程、关闭循环。如果在同一个线程里反复调用，第二次就会遇到循环已关闭的错误——尤其在单元测试或REPL中容易踩。

• 测试时别每个test_*都用asyncio.run()，改用pytest-asyncio插件或手动管理循环生命周期
• Web框架（如FastAPI）自己管理事件循环，你写的路由函数只需async def，不用也不该自己调asyncio.run()
• 真要多次运行，可复用asyncio.get_event_loop()（注意线程安全），但更稳妥的做法是把主逻辑写成单次run()，内部用asyncio.create_task()并发调度

事情说清了就结束。异步不是加几个async/await就行，关键在于所有I/O路径都得走异步栈——中间断一环，整条链就退化回同步。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python异步编程陷阱：避免阻塞I/O操作》文章吧，也可关注golang学习网公众号了解相关技术文章。