asyncio.Queue 更适合异步场景,因其 put/get 是原生协程,支持 await 且不阻塞 event loop;而 queue.Queue 是同步阻塞的,会导致协程卡死。

asyncio.Queue 为什么比普通 queue.Queue 更适合异步场景
因为 queue.Queue 是线程安全的阻塞式队列,所有 put() 和 get() 都会同步等待,一旦用在 async def 函数里,就会直接阻塞整个 event loop。而 asyncio.Queue 的 put() 和 get() 都是协程函数,原生支持 await,不会打断其他任务执行。
常见错误现象:RuntimeWarning: coroutine 'Queue.put' was never awaited —— 忘记加 await;或者用 queue.Queue 导致程序卡死、CPU 占用低但无响应。
-
asyncio.Queue初始化时可设maxsize,满时put()会挂起,空时get()会挂起,天然适配背压(backpressure) - 不支持多进程共享,只适用于单进程内的协程间通信
- 没有
qsize()的实时保证(并发下可能过时),判断是否为空请用q.empty()或直接await q.get()
如何正确启动生产者和消费者协程并协同退出
不能靠 while True + break 硬等,必须有明确的退出信号机制,否则消费者可能永远 await 在 get() 上。
推荐做法:生产者全部完成后向队列 put 一个特殊哨兵值(如 None),每个消费者收到哨兵就退出;或用 asyncio.Event 统一通知停止。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 多个消费者时,哨兵数量要和消费者数量一致,否则部分消费者会饿死
- 使用
asyncio.gather()启动所有协程,并捕获CancelledError做清理(比如关闭连接、写日志) - 避免在消费者里用
try/except Exception吞掉asyncio.CancelledError,否则asyncio.wait_for()或task.cancel()失效
async def producer(q: asyncio.Queue, items):
for item in items:
await q.put(item)
await asyncio.sleep(0.1) # 模拟异步 IO
for _ in range(CONSUMER_COUNT): # 发送哨兵
await q.put(None)
<p>async def consumer(q: asyncio.Queue, name):
while True:
item = await q.get()
if item is None:
break
print(f"{name} got {item}")
q.task_done()
</p>
如何控制并发数并防止队列无限膨胀
不加限制的生产者可能瞬间把几万条数据塞进 asyncio.Queue,内存暴涨,甚至 OOM。关键不是“能不能放”,而是“要不要现在放”。
- 初始化
asyncio.Queue(maxsize=N),比如maxsize=100,让生产者在队列满时自动 await 挂起,实现自然节流 - 避免在生产者中用
asyncio.create_task()无节制地发任务,应配合asyncio.Semaphore控制并发生产速率 - 消费者调用
q.task_done()后,生产者可用await q.join()等待所有已入队任务被处理完,适合做阶段性同步点
实际项目中容易忽略的异常传播与调试问题
协程里的异常默认不会冒泡到主 task,尤其在 asyncio.gather() 中,某个消费者出错可能静默失败,导致队列积压、程序假死。
- 务必在每个消费者内部包一层
try/except,至少记录sys.exc_info(),再 re-raise 或标记失败 - 不要依赖
q.get()的返回值做类型断言——网络解析失败、JSON 解析异常等都可能发生在消费者内部,而非队列操作本身 - 调试时临时启用
asyncio.get_event_loop().set_debug(True),能暴露未被 await 的协程、慢回调等隐性问题
最常被跳过的细节:忘记调用 q.task_done()。一旦漏掉,q.join() 就永远等不到完成,后续逻辑卡住。这不是语法错误,也不报异常,只有行为异常时才暴露。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










