Cucumber场景通过TestNG运行时无法并行执行的解决方法咨询

我之前也碰到过一模一样的问题！折腾了好一阵才把场景并行跑起来，下面是我亲测有效的完整配置方案，分几个关键环节梳理：

你的Runner类必须继承AbstractTestNGCucumberTests，这是Cucumber和TestNG联动的核心基类。另外要注意，不要在Runner类里自己设置parallel参数，把并行控制交给TestNG和Maven插件来处理。示例代码如下：

import io.cucumber.testng.AbstractTestNGCucumberTests;
import io.cucumber.testng.CucumberOptions;

@CucumberOptions(
    features = "src/test/resources/website", // 你的feature文件夹路径
    glue = "com.yourpackage.stepdefinitions", // 步骤定义类所在包
    plugin = {"pretty", "html:target/cucumber-reports.html"}
)
public class TestRunner extends AbstractTestNGCucumberTests {
    // 这里不需要额外写代码，继承基类即可
}

在testng.xml里，你需要把parallel属性设为methods——因为每个Cucumber场景在TestNG中会被解析成一个独立的test method，这样才能让场景并行执行。同时设置合理的thread-count（根据你的CPU核心数调整，比如4-8）：

<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name="Cucumber Parallel Suite" parallel="methods" thread-count="5">
    <test name="Parallel Cucumber Tests">
        <classes>
            <class name="com.yourpackage.TestRunner"/> <!-- 替换成你的Runner类全路径 -->
        </classes>
    </test>
</suite>

很多人会忽略这一步：Surefire插件需要正确配置才能让TestNG的并行生效。你需要指定testng.xml的路径，同时设置forkCount（和thread-count对应），确保插件会fork多个进程来执行测试：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M7</version> <!-- 用最新稳定版即可 -->
            <configuration>
                <suiteXmlFiles>
                    <suiteXmlFile>testng.xml</suiteXmlFile> <!-- 你的testng.xml路径 -->
                </suiteXmlFiles>
                <forkCount>5</forkCount> <!-- 和thread-count保持一致或略高 -->
                <reuseForks>true</reuseForks>
            </configuration>
        </plugin>
    </plugins>
</build>

并行跑起来后，很容易因为共享资源出问题，一定要注意：

• 不要用静态变量存储WebDriver或测试数据：每个场景要初始化独立的WebDriver实例，比如在Cucumber的@Before钩子或TestNG的@BeforeMethod里创建，@After/@AfterMethod里销毁。
• 确保步骤定义类无状态：不要在步骤类里保存场景相关的状态，所有数据要么存在Scenario上下文里，要么每次都重新获取。
• 依赖版本兼容：Cucumber-testng、cucumber-java和TestNG的版本要匹配，比如Cucumber 7.x对应TestNG 7.x以上，避免版本冲突导致并行失效。

按照上面的步骤配置完后，执行mvn clean test，你应该就能看到控制台里多个场景同时输出日志，实现并行执行了。我当时就是因为漏了Surefire的forkCount配置，导致TestNG的thread-count完全没生效，一直串行执行。

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