pytest 中使用 `@mock.patch` 类装饰器会导致补丁未自动清理，从而污染后续测试；应改用 `pytest-mock` 插件提供的 `mocker` fixture，在函数级精确控制 mock 生命周期。
在 Pytest 中，直接使用 unittest.mock.patch 的类装饰器（如 @mock.patch(...) 修饰整个测试类）是危险且不推荐的。其根本原因在于：该装饰器会在类定义时立即应用 patch，并默认在类加载后持续生效，而非在测试方法执行完毕后自动还原——尤其当测试跨文件执行（如 pytest 全局运行）时，patch 可能长期驻留于模块命名空间中，导致后续测试（如 sql_loader_test.py 中的用例）意外继承已被 mock 的 SnowFlakeConnector，出现 NonCallableMagicMock 实例复用、ID 相同等“跨测试污染”现象。
✅ 正确做法是使用 pytest-mock 插件提供的 mocker fixture：
pip install pytest-mock
然后在测试中按需、按作用域启用 patch：
AI舌诊面诊问诊医疗系统+诊疗商城系统源码
下载
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
# test/kernel_application_test.py
class TestExecuteApplication:
def test_connects_with_config(self, mocker):
# ✅ 函数级 patch：仅在本测试方法内生效，退出自动还原
mock_connector = mocker.patch('customlib.snowflake.SnowFlakeConnector', autospec=True)
# 调用被测代码（例如初始化应用）
from customlib.kernel import KernelApplication
app = KernelApplication()
app.execute()
# 断言 mock 行为
mock_connector.assert_called_once()
assert mock_connector.return_value.connect.called
def test_handles_failure_gracefully(self, mocker):
# ✅ 每个测试独立 patch，互不干扰
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
class TestSqlLoader:
def test_loads_from_query(self, mocker):
# ✅ 即使 kernel_application_test.py 已运行过，此处仍是干净的原始类
mock_connector = mocker.patch('customlib.snowflake.SnowFlakeConnector', autospec=True)
mock_cursor = mock_connector.return_value.cursor.return_value
mock_cursor.fetchall.return_value = [("data1",), ("data2",)]
loader = SqlLoader()
result = loader.load("SELECT * FROM table")
assert len(result) == 2⚠️ 注意事项：
- 不要继承 unittest.TestCase：Pytest 原生不依赖 unittest 运行机制，继承它不仅无益，还可能干扰 fixture 注入和生命周期管理；
- 避免全局/模块级 patch：如 @patch(...) 修饰模块或使用 patch(...).start() + stop() 手动管理，极易遗漏还原；
- 优先使用 mocker.patch 而非 mock.patch：mocker fixture 内置自动 cleanup 逻辑，确保每个测试函数结束后所有 patch 均被撤销；
- 若需类级别 patch（极少数场景），可使用 mocker.patch 在 setup_method 或 pytest.fixture(scope="function") 中声明，但务必坚持“最小作用域”原则。
总结：Pytest 的 mock 管理哲学是「显式、局部、自动还原」。放弃类装饰器式的“一劳永逸”，转而拥抱 mocker fixture 的函数级精准控制，是保障测试隔离性与可靠性的关键实践。
