讲师中心 微信公众号
AI工具推荐 视频效率加速

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

雨丽同学_7428

雨丽同学_7428

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

|

172人浏览过

|

来源于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免费学习笔记(深入)”;

python-parallelization
python-parallelization

将顺序 Python 代码转换为并行/并发实现,用于在需要并行化 Python 代码、提升性能时使用。

下载
  • 检查是否已有运行中的循环: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工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

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

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

533

2026.02.04

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

220

2026.06.29

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

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

3998

2023.08.10

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

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

1109

2025.12.24

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

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

383

2026.01.21

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

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

539

2026.01.21

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

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

389

2026.02.06

C++多线程并发控制与线程安全设计实践
C++多线程并发控制与线程安全设计实践

本专题围绕 C++ 在高性能系统开发中的并发控制技术展开,系统讲解多线程编程模型与线程安全设计方法。内容包括互斥锁、读写锁、条件变量、原子操作以及线程池实现机制,同时结合实际案例分析并发竞争、死锁避免与性能优化策略。通过实践讲解,帮助开发者掌握构建稳定高效并发系统的关键技术。

213

2026.03.16

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

80

2026.10.10

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn