本文详解如何在 gradle 项目中启用 cucumber 的并行执行能力，特别支持 scenario outline 中每个 examples 行独立并发运行，涵盖依赖配置、junit platform suite 集成、命名策略适配及关键配置项设置。
本文详解如何在 gradle 项目中启用 cucumber 的并行执行能力，特别支持 scenario outline 中每个 examples 行独立并发运行，涵盖依赖配置、junit platform suite 集成、命名策略适配及关键配置项设置。
在 Gradle 构建环境下实现 Cucumber 测试的真正并行化（尤其是针对 Scenario Outline 的每条 Examples 数据行），并非开箱即用，但完全可行——关键在于正确组合 JUnit 5 平台引擎、Cucumber 的 JUnit Platform Engine 以及 Gradle 的测试执行机制。与 Maven 生态不同，Gradle 对细粒度测试实例（如单个数据驱动示例）的并发调度原生支持较弱，需通过显式配置补足元数据识别与执行策略。
✅ 核心配置步骤
1. 声明兼容依赖（推荐使用 BOM 管理版本）
确保使用 Cucumber 7.10+ 与 JUnit 5.9+（支持 cucumber.execution.parallel.enabled），并在 build.gradle 中配置如下：
plugins {
id 'java'
}
repositories {
mavenCentral()
}
dependencies {
testImplementation(platform("org.junit:junit-bom:5.10.2"))
testImplementation(platform("io.cucumber:cucumber-bom:7.14.1"))
testImplementation("io.cucumber:cucumber-java")
testImplementation("io.cucumber:cucumber-junit-platform-engine")
testImplementation("org.junit.platform:junit-platform-suite")
testImplementation("org.junit.jupiter:junit-jupiter")
}? 提示：cucumber-junit-platform-engine 是启用并行执行的必要模块，替代已废弃的 cucumber-junit；junit-platform-suite 则用于声明测试套件入口。
2. 启用 JUnit Platform 并修复场景识别歧义
Gradle 默认无法区分同一 Scenario Outline 下不同 Examples 实例（它们共享相同类/方法名）。需强制启用长命名策略，使每个示例生成唯一显示名：
tasks.withType<Test> {
useJUnitPlatform()
systemProperty("cucumber.junit-platform.naming-strategy", "long")
}该配置确保测试报告和 IDE 中能准确标识 Author from API matches author on book page(item1)、(item2) 等独立实例，为并行调度提供基础。
3. 创建 JUnit Platform Suite 入口类
新建一个 Java 类（如 src/test/java/io/cucumber/skeleton/RunCucumberTest.java），作为测试启动点：
package io.cucumber.skeleton;
import org.junit.platform.suite.api.ConfigurationParameter;
import org.junit.platform.suite.api.IncludeEngines;
import org.junit.platform.suite.api.SelectClasspathResource;
import org.junit.platform.suite.api.Suite;
import static io.cucumber.junit.platform.engine.Constants.GLUE_PROPERTY_NAME;
@Suite
@IncludeEngines("cucumber") // 指定使用 Cucumber 引擎
@SelectClasspathResource("io/cucumber/skeleton") // 指向 feature 文件所在 classpath 路径（如 src/test/resources/io/cucumber/skeleton）
@ConfigurationParameter(key = GLUE_PROPERTY_NAME, value = "io.cucumber.skeleton") // 指定 step definition 包路径
public class RunCucumberTest {
}此 @Suite 类是 Gradle 执行 Cucumber 测试的唯一入口，绕过 Gradle 对传统 @RunWith(Cucumber.class) 的不兼容限制。
4. 启用并行执行（关键一步）
在 src/test/resources/junit-platform.properties 中添加：
cucumber.execution.parallel.enabled=true
✅ 此配置由 cucumber-junit-platform-engine 解析，将自动为每个 Examples 行创建独立的 TestInstance，并交由 JUnit Platform 的并行执行器调度（默认线程数 = CPU 核心数，可通过 junit.jupiter.execution.parallel.config.dynamic.factor 等进一步调优）。
? 验证效果
运行命令：
./gradlew test --tests "io.cucumber.skeleton.RunCucumberTest"
观察控制台输出：你会看到类似 Started running scenario 'Author from API matches author on book page(item1)' on thread pool-1-thread-1 的日志，且多个 item* 示例明显交错执行，证实并行生效。
⚠️ 注意事项与最佳实践
- 线程安全前提：确保 Step Definition 中无共享可变状态（如静态 WebDriver 实例），推荐使用 @Before/@After + ThreadLocal 或依赖注入框架管理生命周期。
-
资源隔离：若涉及浏览器或 HTTP 客户端，务必为每个线程初始化独立实例（例如 ThreadLocal
）。 - 调试友好性：启用 long 命名策略后，IDE（IntelliJ IDEA 2023.2+）可直接点击单个 Examples 行运行/调试，大幅提升开发效率。
-
性能调优：如需限制并发数，可在 junit-platform.properties 中添加：
junit.jupiter.execution.parallel.config.fixed.parallelism=4
- 避免误用：cucumber.execution.parallel.enabled=true 仅对 Scenario Outline 的 Examples 行有效；普通 Scenario 不会自动拆分，并行单位始终是“单个示例实例”。
通过以上四步配置，你已在 Gradle 项目中构建起稳定、可扩展、符合现代测试架构的 Cucumber 并行执行体系——不仅解决“能否并行”的问题，更确保了可维护性、可观测性与工程落地性。
