如何在 Pytest 中正确管理 Mock 补丁作用域以避免跨测试污染

pytest 中使用 `@mock.patch` 类装饰器会导致补丁泄漏到后续测试中，破坏测试隔离性；应改用 `pytest-mock` 提供的 `mocker` fixture，在函数级精准控制 mock 生命周期，确保每个测试独立、可重复、无副作用。

在 Pytest 中，测试隔离性（test isolation）是核心原则，但直接沿用 unittest.mock.patch 的类装饰器（如 @mock.patch(...)）极易引发补丁“残留”问题——正如你在 TestExecuteApplication 类中打的补丁，意外影响了后续执行的 sql_loader_test.py 中未打补丁的测试。这是因为 @mock.patch 作为类装饰器时，会在类定义阶段即应用 patch，并仅在该类所有测试方法执行完毕后才自动清理；而 Pytest 默认按文件/模块顺序执行测试，且不保证 unittest.TestCase 子类的 patch 会跨模块自动还原，尤其当混合使用 unittest 风格类与纯 Pytest 风格测试时，mock 状态可能被持久化至 Python 解释器生命周期内，导致对象 ID 复用（如你观察到的 id='5159517536'），造成严重干扰。

✅ 正确做法：使用 pytest-mock 插件 + mocker fixture
首先安装插件（它已内置 pytest 兼容的 mock 管理逻辑）：

pip install pytest-mock

然后重写测试，放弃 unittest.TestCase 继承和类级 @patch 装饰器，改用函数级、fixture 驱动的 mock：

# test/kernel_application_test.py
class TestExecuteApplication:
    def test_connects_with_snowflake(self, mocker):
        # 在单个测试函数内精准 patch，作用域严格限定于此函数
        mock_connector = mocker.patch(
            'customlib.snowflake.SnowFlakeConnector',
            autospec=True
        )

        # 触发被测代码（例如初始化应用）
        from src.kernel import KernelApplication
        app = KernelApplication()

        # 断言 mock 是否被正确调用
        mock_connector.assert_called_once()
        assert mock_connector.return_value.connect.called

    def test_handles_connection_failure(self, mocker):
        mock_connector = mocker.patch(
            'customlib.snowflake.SnowFlakeConnector',
            autospec=True
        )
        mock_connector.side_effect = ConnectionError("Network down")

        # ... 测试异常路径

同样地，在 test/sql_loader_test.py 中也应遵循相同模式：

# test/sql_loader_test.py
def test_loads_sql_from_file(mocker):
    # 此处的 patch 与 kernel_test 完全无关，互不影响
    mocker.patch('builtins.open', mocker.mock_open(read_data="SELECT * FROM t;"))

    from src.sql_loader import SQLLoader
    loader = SQLLoader()
 
   sql = loader.read_query("dummy.sql")

    assert sql.strip() == "SELECT * FROM t;"

? 关键优势与注意事项：

• 自动清理：mocker fixture 在每个测试函数退出时自动 stop() 所有通过它创建的 patch，无需手动 patch.stop() 或上下文管理。
• 无继承负担：Pytest 原生支持普通类/函数，无需继承 unittest.TestCase，避免 unittest 运行器与 pytest 运行器的语义冲突。
• 作用域清晰：mocker.patch() 的生效范围严格绑定于当前测试函数，跨文件、跨类、跨模块均无污染。
• 兼容性保障：pytest-mock 是官方推荐方案，与 pytest-xdist、pytest-asyncio 等主流插件无缝协作。

⚠️ 额外提醒：若历史代码中仍需保留 unittest.TestCase 类（例如需复用某些基类逻辑），请务必改用 setUp/tearDown 中的 patch.start()/patch.stop()，或更推荐——彻底迁移到 Pytest 原生风格，提升可维护性与可靠性。

总之，告别类装饰器式 patch，拥抱 mocker fixture，是保障 Pytest 测试健壮性与可预测性的关键一步。