本文旨在解决spock测试在gradle项目中无法并行执行的问题。通过详细阐述spock与junit jupiter并行执行机制的区别，指导读者如何正确使用spock特有的注解和配置，包括创建spockconfig.groovy文件，从而实现测试用例的高效并行运行，显著提升测试执行速度。
理解并行测试与Spock框架
在现代软件开发中，为了缩短反馈周期，并行执行测试已成为一项重要的优化手段。JUnit 5 (Jupiter) 提供了强大的并行测试能力，允许测试类或测试方法在不同的线程中并发运行。然而，当使用Spock框架编写测试时，即使项目配置了JUnit Jupiter的并行执行参数，Spock测试也可能不会按预期并行运行。这主要是因为Spock虽然基于JUnit Platform运行，但它拥有自己独立的并行执行机制。
问题现象：JUnit Jupiter配置未能生效于Spock测试
当开发者尝试通过在 junit-platform.properties 文件或 Gradle 的 systemProperties 中配置 JUnit Jupiter 的并行执行参数时，例如：
junit.jupiter.execution.parallel.enabled=true junit.jupiter.execution.parallel.mode.default = concurrent junit.jupiter.execution.parallel.mode.classes.default = concurrent junit.jupiter.execution.parallel.config.strategy=fixed junit.jupiter.execution.parallel.config.fixed.parallelism=2
或者在 build.gradle 中：
test {
useJUnitPlatform()
systemProperties([
'junit.jupiter.execution.parallel.enabled': 'true',
'junit.jupiter.execution.parallel.mode.default': 'concurrent',
'junit.jupiter.execution.parallel.mode.classes.default': 'concurrent',
])
}并期望以下Spock测试能够并行执行：
import org.junit.jupiter.api.parallel.Execution // 注意：这是JUnit Jupiter的注解
import org.junit.jupiter.api.parallel.ExecutionMode
import spock.lang.Specification
import spock.lang.Unroll
@Execution(ExecutionMode.CONCURRENT) // 使用了JUnit Jupiter的并行注解
class ExampleTest extends Specification {
@Unroll
@Execution(ExecutionMode.CONCURRENT) // 使用了JUnit Jupiter的并行注解
def "test1: should get valid #testParam"() {
System.out.println("FirstParallelUnitTest first() start => " + Thread.currentThread().getName() +
" id: " + Thread.currentThread().getId());
given:
def test = testParam
expect:
test != null
System.out.println("FirstParallelUnitTest first() end => " + Thread.currentThread().getName() +
" id: " + Thread.currentThread().getId());
where:
testParam << ["one", "two", "three", "four"]
}
// ... 其他测试方法类似
}实际运行日志可能显示所有测试都在同一个线程（例如 Test worker id: 1）中顺序执行，表明并行配置并未生效。
FirstParallelUnitTest first() start => Test worker id: 1 FirstParallelUnitTest first() end => Test worker id: 1 FirstParallelUnitTest first() start => Test worker id: 1 FirstParallelUnitTest first() end => Test worker id: 1 // ... 更多类似输出
这是因为Spock框架虽然运行在JUnit Platform之上，但其并行执行的注解和配置与JUnit Jupiter是独立的。直接使用JUnit Jupiter的 @Execution 注解和 junit.jupiter.execution.parallel.* 属性不会对Spock测试产生影响。
解决方案：启用Spock的并行执行机制
要使Spock测试并行执行，需要遵循Spock框架自身的并行执行配置指南。这主要涉及两个方面：使用Spock特有的并行注解，以及通过 SpockConfig.groovy 文件启用并行执行。
1. 使用Spock的并行注解
首先，需要将测试类和测试方法上使用的JUnit Jupiter并行注解替换为Spock框架提供的注解。
将 org.junit.jupiter.api.parallel.Execution 替换为 spock.lang.Execution。 将 org.junit.jupiter.api.parallel.ExecutionMode 替换为 org.spockframework.runtime.model.parallel.ExecutionMode。
更新后的测试类导入和注解示例如下：
import org.spockframework.runtime.model.parallel.ExecutionMode // Spock的ExecutionMode
import spock.lang.Execution // Spock的Execution注解
import spock.lang.Specification
import spock.lang.Unroll
@Execution(ExecutionMode.CONCURRENT) // 使用Spock的并行注解
class ExampleTest extends Specification {
@Unroll
@Execution(ExecutionMode.CONCURRENT) // 使用Spock的并行注解
def "test1: should get valid #testParam"() {
System.out.println("FirstParallelUnitTest first() start => " + Thread.currentThread().getName() +
" id: " + Thread.currentThread().getId());
given:
def test = testParam
expect:
test != null
System.out.println("FirstParallelUnitTest first() end => " + Thread.currentThread().getName() +
" id: " + Thread.currentThread().getId());
where:
testParam << ["one", "two", "three", "four"]
}
// ... 其他测试方法类似
}2. 配置Spock的并行执行
接下来，需要在项目的测试资源目录（通常是 src/test/resources）下创建一个名为 SpockConfig.groovy 的文件，并在此文件中启用Spock的并行执行功能。
src/test/resources/SpockConfig.groovy：
runner {
parallel {
enabled true // 启用Spock的并行执行
// 可选：配置并行策略和线程数
// strategy "FIXED" // 默认是DYNAMIC
// parallelism 2 // 当strategy为FIXED时有效
}
}重要提示：
- SpockConfig.groovy 文件应放置在 src/test/resources 目录的根包下，以便Spock框架能够自动发现并加载它。
- Spock和JUnit Jupiter的并行执行机制是独立的。在一个框架中启用并行执行不会影响另一个框架。这意味着，如果您的项目同时包含JUnit Jupiter和Spock测试，并且希望它们都并行运行，则需要分别为两者进行配置。
3. 验证并行执行
完成上述配置后，再次运行测试。您将观察到日志输出中出现不同的线程名称和ID，表明测试方法正在并行执行。
FirstParallelUnitTest first() start => ForkJoinPool-1-worker-1 id: 17 FirstParallelUnitTest first() start => ForkJoinPool-1-worker-6 id: 22 FirstParallelUnitTest first() start => ForkJoinPool-1-worker-5 id: 20 FirstParallelUnitTest first() end => ForkJoinPool-1-worker-6 id: 22 FirstParallelUnitTest first() end => ForkJoinPool-1-worker-1 id: 17 FirstParallelUnitTest first() end => ForkJoinPool-1-worker-5 id: 20 // ... 更多并行执行的日志
从日志中可以看到，不同的测试执行块由 ForkJoinPool-1-worker-X 线程处理，并且线程ID也不同，这清晰地表明测试正在并行运行。
Gradle中的额外考虑
虽然Spock的并行执行主要通过其自身的注解和配置实现，但Gradle的 maxParallelForks 配置也值得一提。maxParallelForks 主要控制Gradle在运行测试时可以创建多少个独立的JVM进程来执行测试。这是一种进程级别的并行，与Spock内部的线程级别并行是不同的概念。
subprojects {
tasks.withType(Test) {
maxParallelForks = Runtime.runtime.availableProcessors() // 根据CPU核心数设置进程并行数
}
}如果您的测试套件非常庞大，并且在不同的测试类之间存在资源隔离需求，那么结合 maxParallelForks 和Spock内部的并行执行，可以实现更高效的多层次并行。但对于单个Spock Specification 内部的测试方法并行，Spock自身的配置是关键。
总结
要成功在Spock框架中实现并行测试，核心在于理解并正确应用Spock自身的并行执行机制，而非依赖JUnit Jupiter的配置。这包括：
- 使用Spock特有的注解：将 org.junit.jupiter.api.parallel.Execution 替换为 spock.lang.Execution，并将 org.junit.jupiter.api.parallel.ExecutionMode 替换为 org.spockframework.runtime.model.parallel.ExecutionMode。
- 创建和配置 SpockConfig.groovy 文件：在 src/test/resources 目录下创建此文件，并设置 runner.parallel.enabled true 来启用并行执行。
- 理解独立性：Spock和JUnit Jupiter的并行执行是独立的，需要分别配置。
通过以上步骤，您可以确保Spock测试能够充分利用多核处理器，显著提升测试执行效率，加速开发反馈循环。
