JUnit5运行Cucumber/Playwright测试时无法强制设置超时

你当前的核心问题是：Cucumber通过JUnit 5 Suite运行器并行执行时，JUnit原生的超时配置无法作用到Cucumber的测试场景上，导致CI中卡住的测试无法自动终止。以下是针对性的解决方案：

1. 使用Cucumber专属的超时配置 #

Cucumber自身提供了超时控制参数，优先级高于JUnit的配置，需替换你之前的JUnit相关超时设置：

全局配置（junit-platform.properties） #

添加Cucumber的全局超时参数，覆盖所有Scenario：

# Cucumber全局超时，10分钟
cucumber.execution.timeout.default=10m
# 可选：针对失败重试的超时
cucumber.execution.timeout.retry=5m

针对单个Scenario/Step的细粒度控制 #

• 在Feature文件中给指定Scenario加超时标签：

  @timeout(600000) # 10分钟，单位毫秒
  Scenario: 提交表单验证
    Given 用户打开登录页面
    When 用户输入账号密码
    Then 页面跳转到首页
  

• 在Step定义方法上使用Cucumber的@Timeout注解（注意是io.cucumber.java.Timeout，不是JUnit的org.junit.jupiter.api.Timeout）：

  import io.cucumber.java.Timeout;
  import java.util.concurrent.TimeUnit;
  
  @Given("用户打开登录页面")
  @Timeout(value = 10, unit = TimeUnit.MINUTES)
  public void openLoginPage() {
      // Playwright操作代码
  }
  

2. 兜底：Maven Surefire进程级超时 #

如果Cucumber的超时仍未生效（比如Playwright进程无响应），可以在Surefire插件中配置进程级超时，强制杀掉卡住的测试进程：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M5</version>
    <configuration>
        <!-- 10分钟后终止测试进程 -->
        <forkedProcessTimeoutInSeconds>600</forkedProcessTimeoutInSeconds>
        <!-- 进程终止等待时间 -->
        <forkedProcessExitTimeoutInSeconds>30</forkedProcessExitTimeoutInSeconds>
        <!-- 传递Cucumber全局超时参数 -->
        <systemPropertyVariables>
            <cucumber.execution.timeout.default>10m</cucumber.execution.timeout.default>
        </systemPropertyVariables>
    </configuration>
</plugin>

3. Playwright层面的超时加固 #

部分卡顿可能是Playwright的操作未触发超时，需在Playwright初始化时设置全局操作超时：

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserContext;
import com.microsoft.playwright.Playwright;

public class PlaywrightSetup {
    public static BrowserContext createContext() {
        Playwright playwright = Playwright.create();
        Browser browser = playwright.chromium().launch();
        // 设置全局默认超时10分钟
        return browser.newContext(new Browser.NewContextOptions().setDefaultTimeout(600000));
    }
}

也可以针对单个Playwright操作单独设置超时：

page.waitForSelector("#submit-btn", new Page.WaitForSelectorOptions().setTimeout(30000)); // 30秒超时

为什么之前的方法无效？ #

你之前使用的@Timeout（JUnit）、junit.jupiter.execution.timeout.default都是JUnit 5的原生配置，但Cucumber的JUnit 5引擎并未将这些配置映射到Cucumber的Scenario/Step执行生命周期中，必须使用Cucumber专属的超时参数才能生效。

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