pytest-xdist并行测试中如何确保fixture只执行一次

在使用pytest-xdist进行并行测试时，经常会遇到一个典型问题：当使用-n参数并行运行测试时，原本预期只执行一次的fixture会被多次执行。这种情况尤其常见于需要初始化测试环境（如启动服务、创建数据库连接等）的场景。

问题现象

假设我们有一个类级别的fixture用于准备测试环境：

@pytest.fixture(scope='class', autouse=True)
def prepare_environment():
    print('环境初始化')
    yield
    print('环境清理')

当使用pytest test.py -n 3命令运行测试时，这个fixture会在每个worker进程中各执行一次，导致资源浪费和潜在冲突。

根本原因

pytest-xdist的工作原理是创建多个worker进程来并行执行测试。默认情况下，每个worker进程都会独立加载测试模块并执行fixture，因此scope设置为'class'或'module'的fixture会在每个worker中重复执行。

解决方案

要实现真正的单次执行，需要使用session作用域并结合xdist的调度机制。以下是具体实现方式：

1. 首先将fixture的作用域改为session：

@pytest.fixture(scope='session')
def prepare_environment():
    print('全局环境初始化')
    yield
    print('全局环境清理')

2. 然后通过hook函数确保只在主进程中执行：

def pytest_configure(config):
    if not hasattr(config, 'workerinput'):
        # 只在主进程中执行的代码
        print('主进程初始化')

3. 对于需要共享的资源，可以使用tmp_path_factory等pytest内置机制来创建全局可访问的临时资源。

最佳实践

1. 对于耗时的环境准备（如启动服务），务必使用session作用域
2. 资源清理要确保在所有测试完成后执行
3. 共享资源要处理好进程间同步问题
4. 考虑使用pytest的缓存机制来存储全局状态

注意事项

1. 确保fixture是线程安全的
2. 避免在fixture中使用全局变量
3. 对于数据库操作，考虑使用事务回滚而非每次都重建数据库
4. 监控资源泄漏，特别是在长时间运行的测试会话中

通过以上方法，可以确保在并行测试环境中fixture只执行一次，既提高了测试效率，又保证了测试环境的稳定性。