如何通过Gradle运行标注特定@Issue的所有Spock测试？

我明白你想要的效果——像RSpec那样便捷地运行关联同一个Issue的所有测试，不管它们分散在哪个测试文件里。下面给你几个实用的方案，不用改太多代码就能实现：

方案1：自定义Gradle任务（推荐，无需修改测试代码） #

这个方法不需要改动现有的Spock测试，只需要在你的build.gradle（或build.gradle.kts）里添加一个自定义任务，专门用来根据Issue ID过滤测试。

Groovy版build.gradle配置： #

// 自定义任务：根据Issue ID运行对应测试
task testByIssue(type: Test) {
    // 从命令行参数获取Issue ID，比如-PissueId=FOOBAR-123
    def targetIssue = project.findProperty('issueId') ?: ''
    
    if (targetIssue) {
        filter {
            includeTestsMatching { testDescriptor ->
                // 检查当前测试方法是否带有@Issue注解，且值匹配目标ID
                testDescriptor.annotations.any { annotation ->
                    annotation.annotationType().simpleName == 'Issue' && 
                    annotation.value() == targetIssue
                }
            }
        }
    }
    
    // 继承默认test任务的类路径和编译输出
    dependsOn testClasses
    testClassesDirs = sourceSets.test.output.classesDirs
    classpath = sourceSets.test.runtimeClasspath
}

使用方式： #

在终端运行以下命令，替换FOOBAR-123为你要测试的Issue编号：

./gradlew testByIssue -PissueId=FOOBAR-123

注意事项： #

确保你的@Issue注解是运行时可见的，否则Gradle无法在运行时读取注解信息。如果还没定义这个注解，要加上@Retention(RUNTIME)：

import java.lang.annotation.Retention
import java.lang.annotation.RetentionPolicy

@Retention(RetentionPolicy.RUNTIME)
@interface Issue {
    String value()
}

方案2：结合Spock的@Tag注解（需修改测试代码） #

如果你愿意给测试方法额外加上Spock原生的@Tag注解，可以利用Gradle内置的标签过滤功能，更简洁地运行测试。

修改测试代码： #

给每个带有@Issue的测试方法加上对应的@Tag：

class FooTest extends Specification { 
    @Issue("FOOBAR-123")
    @Tag("FOOBAR-123")
    def "should foo"() { ... } 

    @Issue("FOOBAR-234")
    @Tag("FOOBAR-234")
    def "should bar"() { ... } 
}

class BarTest extends Specification { 
    @Issue("FOOBAR-123")
    @Tag("FOOBAR-123")
    def "should quux"() { ... } 
}

使用方式： #

直接用Gradle的--tags参数运行：

./gradlew test --tags FOOBAR-123

这个方法的好处是利用了Gradle和Spock的原生功能，配置更简单，但需要修改现有测试代码来添加标签。

方案3：命令行临时过滤（快速验证） #

如果你只是想临时验证某个Issue的测试，不想修改配置或代码，可以用Gradle的--info参数结合日志过滤，快速定位相关测试的执行结果：

./gradlew test --info | grep -A5 -B5 "FOOBAR-123"

不过这个方法不会只运行目标测试，只是过滤输出内容，适合快速排查时使用。

内容的提问来源于stack exchange，提问作者C. Kapakli