python  asyncio常规操作记录

 更新时间:2026年03月21日 14:01:58   作者:mingshili  
本文介绍了Python asyncio的核心并发机制和API,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

Event Loop 执行机制

Event loop 本质是单线程内的无限循环调度器,不断从任务队列取出就绪的任务执行:

while True:
    events = poll_for_ready_events()   # 检查就绪事件(IO完成、定时器到期、回调投递)
    for event in events:
        execute(event.callback)        # 逐个执行

协程遇到 await挂起自身、让出控制权给 loop,loop 去执行其他就绪任务;
等待的操作完成后,loop 恢复该协程继续执行。

一个线程最多运行一个 event loop。

三个核心 API 对比

1.asyncio.create_task(coro)

在当前 loop 内并发调度一个协程,立即返回 asyncio.Task,不阻塞。

async def main():
    task1 = asyncio.create_task(fetch_a())   # 立即调度,不等完成
    task2 = asyncio.create_task(fetch_b())   # 两个协程并发运行
    result_a = await task1                   # 需要结果时再 await
    result_b = await task2

适用场景: 同一个 loop 内同时跑多个异步 IO 任务(并发请求、并发监听等)。

2.asyncio.to_thread(func, *args)

把同步阻塞函数丢到线程池执行,当前协程挂起等待结果,但 event loop 不阻塞。

async def main():
    # time.sleep 是同步阻塞的,直接调用会卡死整个 loop
    await asyncio.to_thread(time.sleep, 5)   # 丢到线程池,loop 继续处理别的
    # 典型场景:CPU 密集计算、没有 async 版本的阻塞 IO 库
    data = await asyncio.to_thread(read_big_file, path)

适用场景: 调用没有 async 版本的阻塞函数(文件 IO、CPU 计算、旧的同步库),
避免卡死 event loop。

await会卡住当前协程吗?

当前协程会等待,但 event loop 和其他协程不受影响:

写法当前协程event loop其他协程
time.sleep(5)全卡
await asyncio.to_thread(time.sleep, 5)不卡正常跑
await asyncio.sleep(5)不卡正常跑

3.asyncio.run_coroutine_threadsafe(coro, loop)

从另一个线程向指定 loop 投递一个协程,返回 concurrent.futures.Future

# 在非 asyncio 的普通线程中:
future = asyncio.run_coroutine_threadsafe(play_audio(data), main_loop)
result = future.result(timeout=10)   # 阻塞等待结果(在当前线程阻塞,不影响 loop)

适用场景: 普通线程需要让某个 event loop 执行一个协程(跨线程投递异步任务)。

相关 API:call_soon_threadsafe

loop.call_soon_threadsafe(callback, *args)

run_coroutine_threadsafe 类似,但投递的是普通回调函数而非协程。

# 从 WebSocket 线程把音频流注册到主线程的 Mixer
self._main_loop.call_soon_threadsafe(mixer.add_stream, stream)

总结对比表

API调用位置投递目标方向返回值
create_task(coro)协程内协程 → 同一个 loopasync → asyncasyncio.Task
to_thread(func)协程内同步函数 → 线程池async → sync → asyncawaitable
run_coroutine_threadsafe(coro, loop)任意线程协程 → 另一个线程的 loopsync → asyncconcurrent.futures.Future
call_soon_threadsafe(cb)任意线程回调 → 另一个线程的 loopsync → sync(callback)None

速记口诀

create_task              → 同 loop 内并发跑协程
to_thread                → 把同步阻塞的东西丢出去,别卡我的 loop
run_coroutine_threadsafe → 从外面往别人的 loop 里塞协程
call_soon_threadsafe     → 从外面往别人的 loop 里塞回调

项目中的实际应用

本项目 AudioReceiverServer 中存在两个线程各自运行一个 event loop:

主线程 event loop                     WebSocket 线程 event loop
┌───────────────────┐                ┌───────────────────┐
│  Mixer 协程        │                │  ws.recv() 协程 A  │
│  其他音频处理 ...   │  ◄── call_soon │  ws.recv() 协程 B  │
│                   │   threadsafe   │  ws.recv() 协程 C  │
└───────────────────┘                └───────────────────┘
  • WebSocket 线程的 loop 同时 await 多个连接的 recv(),谁来数据就恢复谁
  • 需要操作主线程的 Mixer 时,通过 call_soon_threadsafe 把回调投递到主线程 loop

到此这篇关于python asyncio常规操作记录的文章就介绍到这了,更多相关python asyncio内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 关于Python中的海象运算符使用方法详解

    关于Python中的海象运算符使用方法详解

    这篇文章主要介绍了关于Python中的海象运算符“:=”使用方法详解,海象运算符(walrus operator)是 Python 3.8 中引入的一种新的语法,需要的朋友可以参考下
    2023-04-04
  • python 文件管理库 Path常用操作

    python 文件管理库 Path常用操作

    Path库是python常见的文件操作库(以对象形式操作文件路径),本文结合实例代码给大家介绍python文件管理库Path常用操作,感兴趣的朋友跟随小编一起看看吧
    2026-03-03
  • Python集合之set和frozenset的使用详解

    Python集合之set和frozenset的使用详解

    目前Python有两种内置集合类型:set和frozenset,其中set 是可变的,而frozenset 是不可变的。本文将通过示例详细讲解二者的使用,感兴趣的小伙伴可以了解一下
    2022-04-04
  • Django 创建后台,配置sqlite3教程

    Django 创建后台,配置sqlite3教程

    今天小编就为大家分享一篇Django 创建后台,配置sqlite3教程,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-11-11
  • Python编程中闭包的变量作用域问题解析

    Python编程中闭包的变量作用域问题解析

    这篇文章主要介绍了Python编程中闭包的变量作用域问题解析,在学习Python的返回函数的时候,我发现里面涉及了几个问题,在这里为大家分享讲解下
    2021-10-10
  • CentOS系统下Miniconda3安装与Python项目后台运行全攻略

    CentOS系统下Miniconda3安装与Python项目后台运行全攻略

    Miniconda是一个轻量级的Anaconda发行版,它只包含了conda、Python以及一些必要的依赖包,本文将详细介绍如何在CentOS系统上安装Miniconda3,并将Python项目部署到后台运行
    2025-06-06
  • Python应用打包成APK的全部流程记录

    Python应用打包成APK的全部流程记录

    这篇文章主要介绍了Python应用打包成APK的全部流程,遵循正确的步骤,可以轻松地将Python应用转换为在Android设备上运行的APK文件,从而扩展应用的可用平台,需要的朋友可以参考下
    2024-09-09
  • Python重新引入被覆盖的自带function

    Python重新引入被覆盖的自带function

    最近在写python应用时遇到一个问题: 引入某个模块时会自动引入自定义的int到python的namespace中, 从而覆盖了python自带的int function. 因为我们需要使用python的int, 所以不得不找到重新引入这int的方法.
    2014-07-07
  • Python代码实现找到列表中的奇偶异常项

    Python代码实现找到列表中的奇偶异常项

    这篇文章主要介绍了Python代码实现找到列表中的奇偶异常项,文章内容主要利用Python代码实现了从输入列表中寻找奇偶异常项,需要的朋友可以参考一下
    2021-11-11
  • python的Crypto模块实现AES加密实例代码

    python的Crypto模块实现AES加密实例代码

    这篇文章主要介绍了python的Crypto模块实现AES加密实例代码,简单介绍了实现步骤,小编觉得还是挺不错的,具有一定借鉴价值,需要的朋友可以参考下
    2018-01-01

最新评论