如何让pytest-timeout在Windows超时后仅失败单测而非终止整个运行？

Unix 系统：pytest-timeout 的 Signal 模式 #

pytest-timeout 可以实现超时测试仅标记失败、不终止整个测试会话——在类 Unix 系统下，使用 signal 超时方法即可达成需求。

配置方式分两种：

• 全局配置：在 pytest.ini 中添加

  [pytest]
  timeout_method = signal
  timeout = 5  # 默认超时时间，单位秒
  

• 单个测试配置：用装饰器指定

  import pytest
  
  @pytest.mark.timeout(method="signal", timeout=3)
  def test_slow_operation():
      # 模拟耗时操作
      import time
      time.sleep(10)
  

当测试超时，pytest-timeout 会向该测试所在进程发送信号，标记该测试为失败，整个测试运行会继续执行后续用例。

Windows 系统：等效替代方案 #

Windows 不支持 Unix 信号机制，pytest-timeout 的 signal 方法无法生效，默认的 thread 方法会终止整个测试进程，无法满足需求。以下是两种可行的替代方案：

方案1：自定义线程隔离的超时控制 #

通过将测试逻辑放到单独线程中执行，超时后标记测试失败，不影响主线程的测试运行。示例代码如下：

import threading
import time
import pytest

class TestTimeout(Exception):
    pass

def _run_test(target, result):
    try:
        result["output"] = target()
    except Exception as e:
        result["error"] = e

def test_with_timeout():
    # 模拟耗时测试逻辑
    def slow_test():
        time.sleep(5)
    
    result = {}
    test_thread = threading.Thread(target=_run_test, args=(slow_test, result))
    test_thread.start()
    # 设置2秒超时
    test_thread.join(timeout=2)
    
    if test_thread.is_alive():
        pytest.fail("测试超时", pytrace=False)
    if "error" in result:
        raise result["error"]

这种方式完全通过 Python 线程实现，无需额外依赖，能精准控制单个测试的超时，且不会终止整个测试会话。

方案2：结合 pytest-xdist 实现进程隔离 #

pytest-xdist 会将测试用例分发到多个独立进程中执行，结合 pytest-timeout 的 thread 方法，单个测试进程超时终止后，不会影响其他测试进程的运行。

配置步骤：

1. 安装依赖：

   pip install pytest-xdist pytest-timeout
   

2. 在 pytest.ini 中添加配置：

   [pytest]
   addopts = -n auto  # 根据CPU核心数自动分配进程
   timeout_method = thread
   timeout = 5
   

每个测试用例在独立进程中运行，超时后该进程被终止，测试标记为失败，其他测试进程不受影响，继续执行后续用例。

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