如何解决pytest多测试模块共享外部Docker资源的冲突问题？

方案一：全局资源锁控制（优雅方案） #

通过全局锁机制，确保同一时间只有一个测试模块能占用外部资源（如Docker容器），彻底避免资源冲突。

单进程测试场景实现 #

在项目根目录的conftest.py中定义session级的线程锁fixture：

import pytest
from threading import Lock

@pytest.fixture(scope="session")
def resource_lock():
    return Lock()

修改两个子目录conftest.py中的docker_container fixture，添加锁控制：

@pytest.fixture(scope="module")
def docker_container(resource_lock):
    # 加锁，保证同一时间仅一个模块启动/销毁容器
    with resource_lock:
        docker_container = get_docker_container()
        yield docker_container
        shut_down_docker_container(docker_container)

多进程测试场景（如pytest-xdist）实现 #

如果用多进程运行测试，线程锁无法跨进程生效，需改用文件锁：

1. 安装依赖：pip install filelock
2. 修改根目录conftest.py中的锁fixture：

import pytest
from filelock import FileLock
import tempfile
import os

@pytest.fixture(scope="session")
def resource_lock():
    # 创建全局临时锁文件
    lock_path = os.path.join(tempfile.gettempdir(), "external_resource.lock")
    return FileLock(lock_path)

子目录的docker_container fixture代码和单进程场景一致，用with resource_lock:包裹资源操作逻辑即可。

方案二：固定测试模块执行顺序 #

如果更倾向于强制模块执行顺序，可通过以下两种方式实现：

方式1：用pytest-order标记模块 #

安装pytest-order：pip install pytest-order
在tests/a_tests/tests_a.py顶部添加模块级标记：

import pytest
pytestmark = pytest.mark.order(1)

在tests/b_tests/tests_b.py顶部添加：

import pytest
pytestmark = pytest.mark.order(2)

这样整个模块的所有测试用例会按标记的顺序执行，无需逐个用例标记。

方式2：用pytest钩子自定义排序（无需额外库） #

在项目根目录conftest.py中添加收集钩子，直接修改测试执行顺序：

def pytest_collection_modifyitems(items):
    # 定义模块执行优先级顺序
    module_priority = [
        "tests/a_tests/tests_a.py",
        "tests/b_tests/tests_b.py"
    ]
    
    # 给每个测试项分配排序权重
    def get_module_priority(item):
        module_file = item.module.__file__
        for idx, path in enumerate(module_priority):
            if path in module_file:
                return idx
        # 未指定的模块排最后
        return len(module_priority)
    
    # 按权重排序测试项
    items.sort(key=get_module_priority)

内容的提问来源于stack exchange，提问作者Chris J Harris