0

0

Python async 函数为何不能直接调用

舞姬之光

舞姬之光

发布时间:2026-02-24 20:27:12

|

162人浏览过

|

来源于php中文网

原创

async函数调用必须await或用asyncio.run()执行,直接调用仅返回coroutine对象且触发runtimewarning;在同步环境中不可用threading/multiprocessing绕过,应使用asyncio.gather等原生并发机制。

python async 函数为何不能直接调用

async 函数调用会报 RuntimeWarning: coroutine 'xxx' was never awaited

直接写 my_async_func() 不会执行,而是返回一个 coroutine 对象——它只是个“待办事项”,不是“已办事”。Python 会发警告,但不崩溃;很多新手以为函数跑完了,其实什么都没发生。

常见错误现象:
• 控制台没输出、网络请求没发、文件没读
• 单元测试里 assert 总失败,因为结果是 <coroutine object ...></coroutine> 而非真实值
• 在同步脚本(比如普通 .py 文件)里调用后程序秒退

  • 必须用 await:只能在另一个 async def 函数里写 await my_async_func()
  • 顶层调用要用 asyncio.run():比如 asyncio.run(my_async_func()),这是最常用入口
  • 别用 loop.run_until_complete() 手动管理事件循环——除非你真需要控制生命周期(比如嵌入已有线程)

在非 async 上下文中调用 async 函数的三种现实路径

你没法绕过“异步需异步执行”这个前提,但可以选不同封装方式适配场景。

拍客piikee竞拍系统
拍客piikee竞拍系统

拍客竞拍系统是一款免费竞拍网站建设软件,任何个人可以下载使用,但未经商业授权不能进行商业活动,程序源代码开源,任何个人和企业可以进行二次开发,但不能以出售和盈利为目的。安装方法,将www文件夹里面的所有文件上传至虚拟主机,在浏览器执行http://你的域名/install.php或者直接导入数据库文件执行。本次升级优化了一下内容1,程序和模板完美分离。2,优化了安装文件。3,后台增加模板切换功能。

下载
  • asyncio.run():适合脚本、命令行工具、测试入口。它会新建事件循环、运行协程、关掉循环。注意:不能在已有事件循环中重复调用(比如 Jupyter 或 FastAPI 中会报 RuntimeError: asyncio.run() cannot be called from a running event loop
  • asyncio.get_event_loop().run_until_complete():仅限明确知道当前没有活跃循环时(如老版本 Python 或某些嵌入环境),现在基本被 asyncio.run() 取代
  • 把同步代码改造成 async:比如把主逻辑包进 async def main(),再用 asyncio.run(main()) 启动——这是长期维护项目的推荐做法,避免混用阻塞/非阻塞调用

为什么不能用 threading 或 multiprocessing “绕过” await

有人试过 threading.Thread(target=my_async_func).start(),结果发现函数根本不执行,或者报 RuntimeError: no running event loop。这是因为 async 函数依赖当前线程的事件循环,而新线程默认没有。

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

  • 在子线程里手动创建并启动事件循环(asyncio.new_event_loop() + set_event_loop() + run_forever())可行,但复杂且易出错,比如取消协程、异常传播、资源清理都得自己管
  • multiprocessing 更糟:子进程完全无事件循环上下文,await 语法直接报 SyntaxError(因为子进程执行的是纯同步环境)
  • 真正需要并发执行多个 async 任务,应该用 asyncio.gather()asyncio.create_task(),它们共享同一个事件循环,轻量又可控

容易被忽略的 import 和 Python 版本细节

有些问题不是逻辑错,而是环境卡点。比如在 Python 3.6 之前写 async def 会直接语法错误;或忘了导入 asyncio 就调 run()

  • asyncio.run() 是 Python 3.7+ 才有的。3.6 用户必须用 loop = asyncio.get_event_loop() + loop.run_until_complete()
  • asyncio 不是自动导入的:哪怕只用 asyncio.run(),也得显式写 import asyncio
  • Jupyter Notebook 默认有事件循环,但多次运行同一 cell 可能触发 RuntimeError: asyncio.run() cannot be called...——这时该换用 await my_async_func()(因为 notebook cell 支持 top-level await)
事情说清了就结束。async 函数不是“不能调”,而是“不能像 sync 那样调”;真正的门槛不在语法,而在是否愿意把执行模型从“顺序执行”切换到“事件驱动”。很多人卡住,是因为试图在同步世界里硬塞异步零件,而不是先接受“它得活在自己的节奏里”这个前提。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

28

2025.12.22

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

225

2026.02.06

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

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

719

2023.08.10

Java 并发编程高级实践
Java 并发编程高级实践

本专题深入讲解 Java 在高并发开发中的核心技术,涵盖线程模型、Thread 与 Runnable、Lock 与 synchronized、原子类、并发容器、线程池(Executor 框架)、阻塞队列、并发工具类(CountDownLatch、Semaphore)、以及高并发系统设计中的关键策略。通过实战案例帮助学习者全面掌握构建高性能并发应用的工程能力。

95

2025.12.01

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

1

2026.02.24

Golang 性能优化专题:提升应用效率
Golang 性能优化专题:提升应用效率

《Golang 性能优化专题》聚焦 Go 应用在高并发与大规模服务中的性能问题,从 profiling、内存分配、Goroutine 调度、GC 机制到 I/O 与锁竞争逐层分析。结合真实案例讲解定位瓶颈的方法与优化策略,帮助开发者建立系统化性能调优思维,在保证代码可维护性的同时显著提升服务吞吐与稳定性。

1

2026.02.24

Golang 面试题精选:高频问题与解答
Golang 面试题精选:高频问题与解答

Golang 面试题精选》系统整理企业常见 Go 技术面试问题,覆盖语言基础、并发模型、内存与调度机制、网络编程、工程实践与性能优化等核心知识点。每道题不仅给出答案,还拆解背后的设计原理与考察思路,帮助读者建立完整知识结构,在面试与实际开发中都能更从容应对复杂问题。

1

2026.02.24

Golang 运行与部署实战:从本地到云端
Golang 运行与部署实战:从本地到云端

《Golang 运行与部署实战》围绕 Go 应用从开发完成到稳定上线的完整流程展开,系统讲解编译构建、环境配置、日志与配置管理、容器化部署以及常见运维问题处理。结合真实项目场景,拆解自动化构建与持续部署思路,帮助开发者建立可靠的发布流程,提升服务稳定性与可维护性。

3

2026.02.24

Golang 疑难杂症解决指南:常见问题排查与优化
Golang 疑难杂症解决指南:常见问题排查与优化

《Golang 疑难杂症解决指南》聚焦开发过程中常见却棘手的问题,从并发模型、内存管理、性能瓶颈到工程化实践逐步拆解。通过真实案例与调试思路,帮助开发者定位问题根因,建立系统化排查方法。不只给出答案,更强调分析路径与工具使用,让你在复杂 Go 项目中具备持续解决问题的能力。

0

2026.02.24

热门下载

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

精品课程

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

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

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

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