FastAPI lifespan方法测试：Mock失效，实际方法被执行

问题根源 #

你碰到的核心问题是Mock时机不对或者Mock对象指向错误——当LifespanManager启动应用时，实际执行的lifespan上下文已经绑定了原始的migrate_configuration_service_providers函数，你的Patch没覆盖到正确的引用，导致原始代码还是会跑。

具体修复方案 #

1. 精准Patch业务函数的实际引用路径 #

别直接去Patchapp.router.lifespan_context，而是直接Patchmigrate_configuration_service_providers在lifespan函数所在模块中的导入路径。举个例子：
如果你的migrate_configuration_service_providers定义在app/services/config.py，而lifespan函数在app/main.py里导入并调用它，那测试时就要Patchapp.main.migrate_configuration_service_providers。

测试代码示例：

from asgi_lifespan import LifespanManager
from unittest.mock import patch
from app.main import app

async def test_lifespan():
    # 路径必须和lifespan里调用的函数导入路径完全一致
    with patch("app.main.migrate_configuration_service_providers") as mock_migrate:
        async with LifespanManager(app):
            mock_migrate.assert_called_once()

2. 确保Patch在应用初始化前生效 #

如果你的app是模块级别定义的（比如在app/main.py里直接写app = FastAPI()），要确保Patch在导入app之前完成，避免原始lifespan上下文提前绑定。

调整后的测试代码：

from asgi_lifespan import LifespanManager
from unittest.mock import patch

async def test_lifespan():
    # 先Patch，再导入app
    with patch("app.services.config.migrate_configuration_service_providers") as mock_migrate:
        from app.main import app
        async with LifespanManager(app):
            mock_migrate.assert_called_once()

3. 直接替换app的lifespan属性 #

FastAPI的app对象自带lifespan属性，你可以直接替换成一个空的mock上下文管理器，彻底跳过原始逻辑：

from asgi_lifespan import LifespanManager
from contextlib import asynccontextmanager
from app.main import app

async def test_lifespan():
    # 定义一个空的mock lifespan
    @asynccontextmanager
    async def mock_lifespan(app):
        yield
    
    app.lifespan = mock_lifespan
    async with LifespanManager(app):
        # 这里可以加断言，确认原始逻辑没执行
        pass

关键提醒 #

• app.router.lifespan_context是FastAPI内部属性，直接Patch容易因为版本更新失效，优先Patch业务函数更稳妥。
• Python的Patch是基于导入时的引用，不是函数定义的位置，一定要和lifespan函数里调用的导入路径完全匹配。

内容的提问来源于stack exchange，提问作者Myrto Pirli