使用pytest测试asyncio:如何通过模拟事件循环测试try-except块
测试失败的核心原因
- 对Mock的参数使用逻辑错误
第一个测试中使用patch("webrtc.get_running_loop", return_value=RuntimeError)的写法,仅会让被mock的函数返回RuntimeError类对象本身,不会触发异常抛出,因此try分支根本不会进入except捕获逻辑。要让被mock的函数主动抛出异常,必须通过side_effect参数配置。 - 对
__init__的异常处理逻辑认知错误
源码中__init__的try-except块本身设计为捕获所有来自get_running_loop的RuntimeError,将self.loop设为None后打日志,根本不会让RuntimeError向外冒泡传递。因此测试中添加pytest.raises(RuntimeError)的断言逻辑本身就和源码设计冲突,永远无法触发。 - 测试上下文的执行流程错误
带@pytest.mark.asyncio装饰的测试用例本身运行在一个已存在的事件循环上下文中,get_running_loop()会直接拿到当前运行的循环对象,不会抛出RuntimeError。此时self.loop会被直接赋值为当前循环,永远走不到if self.loop is None的分支,因此asyncio.new_event_loop()永远不会被调用,导致monkeypatch的mock对象计数为0。 - 无效的类属性操作
测试中WebRTCConnection.loop = None的操作仅修改了类的属性值,没有改变__init__方法内部的执行逻辑,无法触发源码中判断loop为None的分支。 - 测试用例存在冗余无效代码
第二个模拟RuntimeError的测试中,无意义地引入了未定义的Domain(name="test")逻辑,本身会触发NameError报错,和当前测试__init__分支的目标完全无关。
正确的测试实现
按三个测试场景拆分覆盖所有分支逻辑,完整实现如下:
场景1:覆盖get_running_loop抛出RuntimeError的捕获分支
# webrtc_test.py from unittest.mock import patch, Mock from loguru import logger import asyncio import pytest from webrtc import WebRTCConnection def test_init_catch_runtime_error(monkeypatch): # 1. 模拟get_running_loop抛出RuntimeError mock_get_loop = Mock(side_effect=RuntimeError("no running loop")) monkeypatch.setattr("webrtc.get_running_loop", mock_get_loop) # 2. 模拟logger验证日志调用 mock_logger = Mock() monkeypatch.setattr("webrtc.logger", mock_logger) # 3. 模拟new_event_loop验证后续分支 mock_new_loop = Mock() monkeypatch.setattr("asyncio.new_event_loop", mock_new_loop) # 实例化类,不会向外抛出RuntimeError conn = WebRTCConnection() # 断言所有分支逻辑正确执行 mock_get_loop.assert_called_once() mock_logger.error.assert_called_once_with(RuntimeError("no running loop")) assert conn.loop == mock_new_loop mock_new_loop.assert_called_once()
场景2:覆盖正常获取运行中循环的分支
@pytest.mark.asyncio async def test_init_get_running_loop(): # 异步测试上下文中本身存在运行中的事件循环 current_loop = asyncio.get_running_loop() conn = WebRTCConnection() # 断言实例的loop直接取到当前运行的循环,不会触发new_event_loop assert conn.loop == current_loop
关键注意点
- 不需要额外引入
nest_asyncio.apply(),使用pytest-asyncio的原生异步上下文即可提供运行中的事件循环 - 针对模块导入的函数做mock时,要patch实际使用的模块路径:webrtc模块中从asyncio导入的
get_running_loop,需要patchwebrtc.get_running_loop,而不是patch全局asyncio下的同名函数 - 不要在测试中手动修改类属性来触发分支,所有分支触发要通过模拟函数的返回/抛出行为实现
内容的提问来源于stack exchange,提问作者Nahua Kang
相关产品推荐
相关产品推荐

