Behave中如何为Scenario Outline内单个场景设置超时并续跑

问题背景 #

因环境偶发问题，部分场景执行时长超出预期或挂起，需要终止单个故障场景但继续执行剩余场景。尝试过fixtures及类似runner.abort_by_user的方法，虽能终止测试，但会中断整个执行流程，且未找到为单个场景设置超时的原生方法。现有Feature文件结构如下：

Feature: ...
  Background: ...
    Given ...
  Scenario Outline: ...
    Given ...
    When  ...
    Then  ...
  Examples: A
    | a | b | c |
    ...
    | x | y | z |
    
  
  Scenario Outline: ...
    Given ...
    When  ...
    Then  ...
  Examples: B
    | a | b | c |
    ...
    | x | y | z |

实现方案 #

通过给Behave的Scenario.run方法打补丁，结合线程超时机制实现单个场景的超时监控，超时后终止当前场景并标记失败，后续场景不受影响。

步骤1：编写环境钩子文件（environment.py） #

在项目根目录创建或修改environment.py，添加以下代码：

from behave import runner
import threading

# 自定义超时异常类
class ScenarioTimeout(Exception):
    pass

def patch_scenario_run():
    # 保存原生场景执行方法
    original_run = runner.Scenario.run

    def wrapped_run(self, context):
        # 读取场景标签中的超时配置，默认300秒（可按需调整）
        timeout_seconds = 300
        for tag in self.tags:
            if tag.startswith('timeout='):
                try:
                    timeout_seconds = int(tag.split('=')[1])
                except ValueError:
                    pass
                break

        result = None
        exception = None

        # 子线程中执行场景逻辑
        def run_scenario():
            nonlocal result, exception
            try:
                result = original_run(self, context)
            except Exception as e:
                exception = e

        thread = threading.Thread(target=run_scenario)
        thread.start()
        thread.join(timeout_seconds)

        # 检查线程是否存活，判断是否超时
        if thread.is_alive():
            # 超时后清理资源（示例：关闭浏览器，需根据实际测试场景调整）
            if hasattr(context, 'browser'):
                try:
                    context.browser.quit()
                except Exception:
                    pass
            raise ScenarioTimeout(f"场景 '{self.name}' 执行超时（超过{timeout_seconds}秒），已终止")
        
        # 抛出场景执行中的原始异常
        if exception:
            raise exception
        return result

    # 替换原生的Scenario.run方法
    runner.Scenario.run = wrapped_run

# 初始化时应用补丁
def before_all(context):
    patch_scenario_run()

步骤2：为单个场景设置自定义超时（可选） #

在Feature文件中，通过@timeout=XX标签为特定场景设置超时时间：

@timeout=120
Scenario Outline: 需要短超时的场景
    Given ...
    When ...
    Then ...
Examples: A
    | a | b | c |
    ...

未添加该标签的场景将使用默认超时时间（代码中设置的300秒）。

注意事项 #

1. Python无法安全强制终止线程，超时后需手动清理测试资源（如浏览器、数据库连接等），避免资源泄漏。
2. 超时异常会被Behave捕获，标记当前场景为失败，后续场景（包括Scenario Outline的其他示例）会正常执行。
3. 该方案对Scenario Outline的每个示例都生效，每个示例会被当作独立场景监控超时。

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