0

0

Python 如何在同步代码中调用协程?

舞夢輝影

舞夢輝影

发布时间:2026-01-19 13:51:33

|

132人浏览过

|

来源于php中文网

原创

同步代码调用协程需通过事件循环驱动,推荐Python 3.7+用asyncio.run()启动新循环并运行协程;已有事件循环时用run_until_complete();多线程中须为子线程单独创建并设置事件循环。

python 如何在同步代码中调用协程?

在同步代码中调用协程,核心思路是**启动事件循环并运行协程直到完成**。Python 不允许直接执行协程对象(如 my_coro() 返回的是协程对象,不是结果),必须通过事件循环驱动。最常用、最安全的方式是使用 asyncio.run()(Python 3.7+)。

用 asyncio.run() 直接运行协程

这是最推荐的方案,适用于顶层同步入口(如脚本主逻辑、命令行工具、测试函数等)。它会自动创建新事件循环、运行协程、等待完成、清理资源。

  • 只能调用一次 —— asyncio.run() 会关闭事件循环,重复调用会报错
  • 不能在已有事件循环中调用(例如在 Jupyter、Django 视图、或已运行的 asyncio 程序里)
  • 适合“从同步进入异步”的一次性场景

示例:

import asyncio
<p>async def fetch_data():
await asyncio.sleep(1)
return "done"</p><h1>✅ 正确:在同步函数中调用</h1><p>def sync_func():
result = asyncio.run(fetch_data())  # 阻塞直到协程完成
print(result)  # 输出:done</p><p>sync_func()

在已有事件循环中用 asyncio.get_event_loop().run_until_complete()

当你的程序已经运行着一个事件循环(比如你正在写一个 asyncio 服务,或在 Jupyter 中),就不能再用 asyncio.run()。此时应获取当前循环并运行协程。

立即学习Python免费学习笔记(深入)”;

Amazon Nova
Amazon Nova

亚马逊云科技(AWS)推出的一系列生成式AI基础模型

下载
  • 检查是否已有运行中的循环:asyncio.get_event_loop()asyncio.get_running_loop()(后者更严格,只返回正在运行的)
  • 确保不嵌套调用 —— 同步函数被协程调用时再调此方法会导致 RuntimeError
  • 常见于调试、交互式环境或混合架构中临时触发异步操作

示例:

import asyncio
<p>async def hello():
return "Hello from async!"</p><p>def sync_call_in_loop():
try:
loop = asyncio.get_running_loop()
except RuntimeError:
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
result = loop.run_until_complete(hello())
print(result)</p><p>sync_call_in_loop()

避免在多线程中误用事件循环

每个线程默认没有事件循环。如果你在子线程中调用协程,必须手动创建并设置循环;主线程的循环对子线程不可见。

  • 子线程中:先调 asyncio.new_event_loop(),再 set_event_loop(),然后 run_until_complete()
  • 不要跨线程共享同一个 loop(非线程安全)
  • 更推荐用 asyncio.to_thread()(Python 3.9+)把阻塞操作移到线程池,而不是反向把协程拉进线程

不推荐的做法:自建循环 + run_forever + stop

手动调用 loop.run_forever() 并配合 loop.stop() 容易出错,需手动管理生命周期、回调、异常传播,且难以保证 clean shutdown。除非你正在实现底层框架,否则绕开它。

本质上,同步代码调用协程不是“转换执行模型”,而是“委托给事件循环执行并等待结果”。选对方式的关键是看所处上下文:全新环境用 run(),已有 loop 用 run_until_complete(),多线程注意隔离 loop 实例。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

169

2026.02.04

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

766

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

377

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

33

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

31

2026.01.21

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

104

2026.02.06

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

377

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

33

2026.01.21

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号