协程不是线程
asyncio 的核心是事件循环加协程:协程在遇到 await 时主动让出控制权,事件循环调度其他任务运行。它是单线程协作式并发,不等于并行。理解这一点,就能避免很多误解——比如以为协程里的阻塞调用会被自动挂起。
任何同步阻塞操作(如 time.sleep、未异步化的数据库驱动)都会卡住整个事件循环。必须使用对应的异步版本,例如 asyncio.sleep()、aiohttp、asyncpg。
正确使用并发原语
asyncio.gather() 适合并发执行多个已知任务并汇总结果;create_task() 用于「发射后不管」的后台任务,但要持有引用,防止被垃圾回收。用 Semaphore 限制并发数量,避免瞬时打爆下游服务或耗尽连接池。
超时控制也很关键:asyncio.wait_for() 或 timeout() 上下文管理器能为不确定的外部调用设置上限,防止任务永久挂起。
异常处理与取消
被 gather() 包裹的任务如果在别处已经失败,可能引发「异常从未被检索」的警告。养成习惯:为每个任务附加异常回调,或用 return_exceptions=True 统一处理。任务取消是协作式的——协程需在处理 CancelledError 时清理资源,不能吞掉这个异常。
调试时可开启 asyncio 的调试模式,它会报告执行过久的回调和未等待的协程,是定位问题的重要助手。
什么时候不该用
如果代码主要是 CPU 密集型计算,asyncio 不会带来收益,应改用多进程或原生扩展。异步化也会增加代码复杂度,只有当并发 I/O 确实成为瓶颈时,收益才足以覆盖成本。