pytest批量测试时重复patch同一函数失败，如何解决？

我有两个测试用例，均对同一个函数执行patch操作。单独运行每个测试时一切正常，但运行整个测试文件时，第二个测试会因无法patch该函数而失败，且后续所有函数的patch操作都会失效，仅第一个测试可正常运行。

我尝试了多种方法均未成功：

• 在每个测试中直接使用mocker.patch：

def test_1(mocker):
    mocker.patch('package.class.function')
    response = client.get("/train/1")
    assert response.status_code == 200
    
def test_2(mocker):
    mocker.patch('package.class.function')
    response = client.get("/train/2")
    assert response.status_code == 200

• 使用pytest.mark.parametrize参数化：

@pytest.mark.parametrize("id", [1,2])
def test_x(mocker, id):
    mocker.patch('package.class.function')
    response = client.get(f"/train/{id}")
    assert response.status_code == 200

• 自定义fixture实现patch：

@pytest.fixture
def mock_function(mocker):
    mocker.patch("package.class.function")

def test_1(mocker, mock_function):
    response = client.get("/train/1")
    assert response.status_code == 200
    
def test_2(mocker, mock_function):
    response = client.get("/train/2")
    assert response.status_code == 200

此外，我还尝试将测试放入类中、设置不同scope等方式，均未解决问题。请问如何在多个测试用例中patch同一个函数？

这种情况大概率是patch的目标路径错误，或者被patch的函数在导入阶段已被缓存，导致后续patch无法覆盖原对象。

核心原则：patch被测试代码实际引用的路径 #

pytest-mock的patch生效的关键是：你要patch的路径，必须是被测试代码（比如API路由处理函数）实际导入并使用的那个函数的引用，而非函数定义的原始路径。

举个实际场景：
如果你的路由文件train.py中是这样导入函数的：

from package.class import function

那你应该patch的是train.function，而非package.class.function——因为路由代码里实际调用的是本地导入的function引用，原始模块的函数被patch不会影响已经导入到train.py中的实例。

正确实现方式 #

方式1：修正路径后用fixture复用（推荐） #

@pytest.fixture(autouse=True)  # autouse=True让每个测试自动应用该fixture
def mock_target_function(mocker):
    # 替换为被测试代码实际引用的函数路径
    mock = mocker.patch('train.function')
    # 可统一设置mock返回值，根据业务需求调整
    mock.return_value = {"status": "success"}
    return mock

def test_1(client):
    response = client.get("/train/1")
    assert response.status_code == 200

def test_2(client):
    response = client.get("/train/2")
    assert response.status_code == 200

方式2：每个测试单独patch（确保路径正确） #

def test_1(mocker, client):
    # 使用被测试代码实际引用的路径
    mocker.patch('train.function')
    response = client.get("/train/1")
    assert response.status_code == 200

def test_2(mocker, client):
    mocker.patch('train.function')
    response = client.get("/train/2")
    assert response.status_code == 200

额外排查方向 #

1. 检查被patch函数的导入方式：如果是在类/函数内部动态导入的，要对应调整patch路径。
2. 避免测试外提前导入被测试模块：确保每个测试都能重新加载模块，可手动在fixture中重新导入或使用pytest-factoryboy辅助。
3. 单例类方法的特殊处理：如果是单例类的方法被patch，需确保每个测试后重置单例状态，或者直接patch单例实例的方法而非类方法。

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