pytest会话级fixture跨模块参数覆盖后错误复用问题求解

这是pytest的预期设计，不属于bug。
pytest的session级fixture缓存逻辑，以「fixture定义所在的作用域+参数化位置索引」作为缓存键，既不会按fixture实际返回的参数值匹配实例，也不会因为测试文件内重写了下层依赖fixture，就自动为上层全局session级fixture拆分隔离缓存。

你观察到的异常来自两个逻辑的错位：

• 定义在conftest.py的全局session级fixture expensive，默认绑定的是同层级定义的xfixture的参数序列，完全感知不到test_foo.py里重写的同名xfixture。
• 测试用例ID后面拼接的[3-10]只是pytest根据当前测试模块可见的fixture参数生成的展示标签，和实际从缓存中取出的expensive实例没有绑定关系，所以才会出现标签显示参数为3、实际拿到的是之前x=1时生成的实例的问题。

你补充提到的「非参数化硬编码重写x依然失败」也是同一个原因：全局的expensive不会调用测试模块内重写的x，只会按全局x的参数顺序生成实例，再按执行顺序把实例塞给后续的测试用例。

方案1：全局钩子统一按模块分配参数（推荐，无代码重复） #

使用pytest内置的pytest_generate_tests钩子统一管理x的参数集，按测试所属模块匹配对应的参数范围，同时把参数化的scope设为session，保证相同参数组合的高开销fixture只初始化一次。
修改后的conftest.py代码如下：

import pytest

# 全局默认x参数集
DEFAULT_X = [1, 2]
# 特殊模块自定义x参数集映射
CUSTOM_X_PER_MODULE = {
    "test_foo.py": [3]
}

def pytest_generate_tests(metafunc):
    if "x" not in metafunc.fixturenames:
        return
    # 获取当前测试所属的文件名
    current_module = metafunc.module.__name__.split(".")[-1]
    # 匹配对应参数集
    target_x_params = CUSTOM_X_PER_MODULE.get(current_module, DEFAULT_X)
    # 按session级别做参数化，同参数组合复用fixture实例
    metafunc.parametrize("x", target_x_params, scope="session")

@pytest.fixture(scope="session", params=[10])
def y(request):
    return request.param

@pytest.fixture(scope="session")
def expensive(x, y):
    # 实际场景下这里放启动容器的高开销逻辑
    return f"expensive[{x}, {y}]"

使用这种写法时，test_foo.py不需要重写任何fixture，直接编写测试逻辑即可，pytest会自动给该模块的测试分配x=3的参数，且expensive实例会按实际的x、y值缓存，不会跨参数组合复用。

方案2：同模块重写完整依赖链（适合自定义场景少的情况） #

如果不想修改全局conftest逻辑，可以在需要自定义参数的测试模块内，把依赖链上相关的session级fixture全部重写一遍，让模块内的expensive直接绑定同模块定义的x，就不会复用全局conftest里生成的expensive实例。
修改后的test_foo.py代码如下：

import pytest

@pytest.fixture(scope="session", params=[3])
def x(request):
    return request.param

# 重写同模块的expensive，绑定当前模块的x
@pytest.fixture(scope="session")
def expensive(x, y):
    return f"expensive[{x}, {y}]"

def test_foo(expensive):
    assert expensive in {"expensive[3, 10]"}

这种写法的缺点是会有少量fixture定义的重复代码，但逻辑直观，不需要调整全局配置。

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