如何解决Python 3.11中TaskGroup导致的异步测试异常_优化异步fixture

大宇姑娘_6971

大宇姑娘_6971

2026-05-24

480人浏览

原创

TaskGroup在pytest中抛出RuntimeError: no running event loop,根本原因是其被用于无运行事件循环的上下文(如同步fixture、conftest.py初始化阶段),须严格限定在async test函数或启用strict模式的async fixture内,并配合event_loop fixture和pytest-asyncio插件使用。

如何解决python 3.11中taskgroup导致的异步测试异常_优化异步fixture

TaskGroup在pytest中抛出RuntimeError: no running event loop

Python 3.11 引入的 asyncio.TaskGroup 要求必须在运行中的 event loop 内使用,而 pytest 默认不启动 loop(尤其在非 async test 函数里调用 async fixture 时)。常见报错是:RuntimeError: no running event loop 或 RuntimeError: Task group is closed。

根本原因不是 TaskGroup 本身有问题,而是它被创建在了没有 loop 的上下文中——比如同步 fixture、setup_method、或 pytest 的 setup 阶段。

  • 只在真正的 async test 函数(即用 async def test_... 定义的)内部使用 TaskGroup,才安全
  • 避免在 @pytest.fixture(未标记 scope="function" 且无 autouse=True)中直接实例化 TaskGroup
  • 若 fixture 必须异步初始化资源,改用 asyncio.create_task + await asyncio.gather(...) 替代 TaskGroup,更可控

如何正确编写支持TaskGroup的async fixture

pytest 原生不支持 async fixture,需依赖 pytest-asyncio 插件,并显式声明 asyncio_mode = "auto" 或用 @pytest.mark.asyncio 标记测试函数。但 fixture 本身不能是 async def ——除非你用 pytest-asyncio>=0.23.0 并启用 asyncio_mode = "strict"。

推荐做法:用 event_loop fixture 注入已启动的 loop,再在 async fixture 中用 asyncio.TaskGroup 管理子任务:

import pytest
import asyncio
<p>@pytest.fixture
def event_loop():
loop = asyncio.new_event_loop()
yield loop
loop.close()</p><p>@pytest.fixture
async def db_pool(event_loop):
async with asyncio.TaskGroup() as tg:</p><h1>注意:此处 tg 是在 event_loop 已运行的前提下创建的</h1><pre class="brush:php;toolbar:false;">    tg.create_task(init_db())
    tg.create_task(warm_up_cache())
return await get_pool()

关键点:fixture 必须声明为 async def,且 pytest 配置中启用 strict 模式;否则会静默降级为同步执行,导致 TaskGroup 失效。

Forge — Python Developer
Forge — Python Developer

Python开发助手 — 自动化脚本、API封装、命令行工具、数据管道、网页爬虫。经过测试的代码,包含错误处理和文档。当你需要...

下载

为什么在conftest.py里用TaskGroup常出错

很多用户把 TaskGroup 放进 conftest.py 的全局 fixture(如 pytest_configure 或模块级 autouse=True fixture),结果一跑就崩。这是因为 conftest 加载和 fixture 解析发生在 pytest 初始化阶段,此时 event loop 还没启动,甚至可能压根没被创建。

  • pytest_configure 和 pytest_sessionstart 是纯同步 hook,无法 await,也不能启动 loop
  • 模块级或 session 级的 async fixture 在 pytest-asyncio 中默认不被支持(除非显式配置 loop_scope = "session")
  • 若真需 session 级异步初始化,改用同步方式预热(如提前启动线程/进程),或拆成 lazy-init:首次调用时再用 TaskGroup 初始化

替代TaskGroup的轻量方案:asyncio.create_task + gather

当兼容性或控制粒度更重要时,asyncio.create_task + await asyncio.gather(...) 更稳妥,尤其适合 fixture 场景:

@pytest.fixture
async def service_client(event_loop):
    task1 = asyncio.create_task(start_server())
    task2 = asyncio.create_task(connect_to_redis())
    await asyncio.gather(task1, task2)  # 等全部完成
    return Client()

这个写法绕过了 TaskGroup 的生命周期约束,也不依赖 __aenter__ 的 loop 检查。缺点是错误传播不如 TaskGroup 精确(单个 task 失败不会自动 cancel 其他),但对 fixture 初始化这类“全成功才可用”的场景影响不大。

真正容易被忽略的是:即使用了 TaskGroup,也要确保所有 create_task 调用都在同一个 async with 块内 ——跨 scope 的 task 可能被提前 cancel,且不会报错,只表现为资源未就绪。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1771

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4584

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1729

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

27057

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3267

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3287

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1203

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2543

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习