pytest monkeypatch.syspath_prepend 跨测试函数修改残留问题

monkeypatch.syspath_prepend的回滚逻辑本身没有问题，函数级fixture执行结束后，追加的mock库路径确实会被从sys.path中移除，pytest的fixture作用域规则是正常生效的。
真正导致测试隔离失效的是Python原生的模块导入缓存机制：当proprietary_lib第一次被成功导入后，模块对象会被存入全局的sys.modules缓存字典，后续所有执行import proprietary_lib的逻辑，Python不会再重新遍历sys.path查找模块文件，直接返回缓存中已有的模块对象。这就是为什么即使sys.path已经回滚，第二个测试还是能导入到mock版本的库，不会抛出ModuleNotFoundError。
你观察到的复现规律完全符合这个逻辑：单独运行第二个测试时，没有前置代码导入过proprietary_lib，sys.modules中不存在对应缓存，此时sys.path里也没有mock库路径，导入自然报错；按顺序运行整个测试模块时，第一个测试已经将mock版的proprietary_lib写入缓存，第二个测试的导入逻辑直接命中缓存，根本不会走到路径查找的步骤。

你可以根据自己的桩代码维护方式选其中一种：

方案1：在现有fixture中增加缓存清理逻辑 #

这是改动最小的方案，只需要在fixture的teardown阶段，把导入过的mock专有库从sys.modules缓存中删掉即可：

import pytest
import sys

@pytest.fixture(scope="function")
def useFakeLib(monkeypatch):
    mock_lib_path = "path/to/mockLib"
    monkeypatch.syspath_prepend(mock_lib_path)
    # 测试结束后执行清理
    yield
    sys.modules.pop("proprietary_lib", None)

代码里pop的第二个参数传None是为了兼容测试逻辑未实际导入专有库的场景，避免触发KeyError。

方案2：直接通过monkeypatch注入mock模块，不修改sys.path #

如果不想处理路径和缓存的连锁问题，可以完全绕开文件系统导入逻辑，直接构造mock模块对象注入sys.modules，monkeypatch会自动回滚对sys.modules的修改，不需要手动写清理逻辑，隔离性更稳定：

import pytest
import sys
from types import ModuleType

@pytest.fixture(scope="function")
def useFakeLib(monkeypatch):
    # 构造mock专有库对象
    mock_proprietary_lib = ModuleType("proprietary_lib")
    # 绑定桩方法/属性
    def fakeFunction():
        return "I am fake."
    mock_proprietary_lib.fakeFunction = fakeFunction
    # 注入导入缓存，测试结束后monkeypatch自动撤销修改
    monkeypatch.setitem(sys.modules, "proprietary_lib", mock_proprietary_lib)

如果你已经维护了独立的桩库文件，也可以在fixture里先临时加载桩模块拿到对象，再通过上述方式注入，不需要把桩库路径长期留在sys.path里。

注意：所有涉及proprietary_lib的导入语句必须放在测试函数或者fixture内部，不要在测试模块顶层写导入逻辑。顶层导入会在测试模块加载阶段就执行，此时fixture还未启动，要么直接触发导入错误，要么模块缓存会在整个模块运行周期常驻，彻底破坏测试隔离。

改完后可以在两个测试内部分别打印两个状态确认隔离生效：

• 打印sys.path，确认未使用fixture的测试运行时，path/to/mockLib不在路径列表中
• 打印sys.modules.get("proprietary_lib")，确认未使用fixture的测试启动时，对应缓存不存在

内容的提问来源于stack exchange，提问作者Matt Billman