如何在特定条件触发时终止pytest所有并行测试脚本的执行？

在pytest并行（如基于pytest-xdist）运行Selenium测试时，要实现仅当特定自定义条件满足时终止整个测试套件（而非普通失败就终止），可通过以下两种方式实现：

方法1：利用pytest缓存跨worker同步终止信号 #

由于pytest-xdist的每个worker是独立进程，需通过共享缓存传递终止指令：

1. 在项目根目录创建conftest.py，添加钩子函数：

import pytest

def pytest_runtest_setup(item):
    # 每次测试启动前检查是否存在终止信号
    if item.config.cache.get("should_terminate", False):
        pytest.exit("触发自定义终止条件，停止所有测试", returncode=1)

def pytest_sessionfinish(session, exitstatus):
    # 测试结束后清理缓存标记（可选）
    session.config.cache.set("should_terminate", False)

2. 在测试用例中触发终止逻辑：

def test_check_critical_page(driver, request):
    # 自定义条件判断示例：检测页面标题是否符合终止要求
    if driver.title == "系统异常页面":
        # 向缓存写入终止信号
        request.config.cache.set("should_terminate", True)
        # 终止当前worker的测试执行
        pytest.exit("触发关键终止条件", returncode=1)

当某个worker触发终止信号后，其他worker会在后续测试的启动阶段检测到缓存中的标记，进而停止执行。

方法2：使用pytest-xdist广播事件（更高效） #

针对pytest-xdist环境，可直接通过事件广播机制通知所有worker终止：

1. 在conftest.py中配置事件监听与广播逻辑：

import pytest
from pytest_xdist import get_xdist_worker_id

def pytest_configure(config):
    # 注册自定义终止事件（仅主进程执行）
    if hasattr(config, "xdist_controller"):
        config.xdist_controller.register_custom_event("terminate_all")

def pytest_runtest_setup(item):
    worker_id = get_xdist_worker_id(item.config)
    if worker_id == "master":
        return
    # 检查是否收到终止广播
    if item.config.xdist_worker.has_event("terminate_all"):
        pytest.exit("收到全局终止信号，停止测试", returncode=1)

def trigger_global_terminate(config):
    # 向所有worker广播终止指令
    if hasattr(config, "xdist_controller"):
        config.xdist_controller.broadcast("terminate_all")

2. 在测试用例中触发广播：

def test_detect_critical_error(driver, request):
    # 自定义条件判断示例：检测页面是否包含致命错误标识
    if "FATAL_ERROR" in driver.page_source:
        # 触发全局终止广播
        trigger_global_terminate(request.config)
        # 终止当前测试
        pytest.exit("检测到致命错误，终止所有测试", returncode=1)

此方法通过xdist的内置事件系统直接同步信号，比缓存方式更高效，适合大规模并行测试场景。

注意事项 #

• 确保使用较新版本的pytest和pytest-xdist，避免兼容性问题
• 自定义条件的判断逻辑需精准，避免误触发终止
• 两种方法中，pytest.exit()仅终止当前worker，其他worker需通过缓存/事件检测主动停止

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