基于抽象类在Gradle中区分集成测试与单元测试的问题

你遇到的核心问题其实是JUnit的@Category注解本身不支持继承——哪怕给抽象基类加了这个注解，子类也不会自动继承该分类标记，这就是为什么单层级直接给测试类加注解时生效，但继承抽象类时就失效的原因。下面给你几个可行的解决方案：

方案1：使用可继承的自定义元注解 #

这是最优雅的处理方式，通过封装带@Inherited的自定义注解，让子类自动继承分类标记：

1. 先创建一个结合了@Category和@Inherited的自定义注解：

import org.junit.experimental.categories.Category
import java.lang.annotation.Inherited

@Inherited
@Category(com.foo.bar.baz.E2ESpec.class)
@interface E2ETest {}

2. 把抽象基类上的@Category替换成这个自定义注解：

@E2ETest
abstract class AbstractSpec extends Specification {
    // 基类共享逻辑
}

3. 实际测试子类只需继承基类即可，不用额外加注解：

class ActualSpec extends AbstractSpec {
    // 测试用例
}

配置完成后，Gradle的e2eTest任务就能正确识别所有继承AbstractSpec的测试类了。

方案2：调整Gradle任务，通过类规则匹配 #

如果不想修改注解结构，也可以直接在Gradle任务中通过类名、包路径筛选集成测试，绕开@Category的继承限制：

比如你的集成测试类都以E2ESpec结尾，或者放在特定包下，可以这样配置：

task e2eTest(type: Test) {
    useJUnit() // 若使用Spock 2.x及以上，建议换成 useJUnitPlatform()
    // 按类名后缀匹配
    include '**/*E2ESpec.class'
    // 或者按包路径匹配，比如所有e2e子包下的测试
    // include 'com/foo/bar/baz/e2e/**/*.class'
}

方案3：自定义Gradle测试过滤器，扫描父类注解 #

如果坚持要使用@Category注解，也可以通过Gradle的测试过滤器，递归检查测试类及其父类的注解：

task e2eTest(type: Test) {
    useJUnit()
    
    filter {
        setIncludeSpec { testDesc ->
            def targetCategory = com.foo.bar.baz.E2ESpec.class
            // 递归遍历类的继承链，检查是否带有目标Category注解
            def checkClassChain = { Class<?> clazz ->
                if (clazz == Object) return false
                def hasTargetCategory = clazz.annotations.any { ann ->
                    ann.annotationType() == Category && ann.value().contains(targetCategory)
                }
                hasTargetCategory ? true : checkClassChain(clazz.superclass)
            }
            checkClassChain(testDesc.testClass)
        }
    }
}

这个方法会逐层检查测试类的父类，只要任意层级的父类带有@Category(E2ESpec)，就会被纳入e2eTest任务。

额外注意事项 #

• 确保E2ESpec是一个public的空标记接口（没有任何方法），且类路径配置正确。
• 若使用Spock 2.x及以上版本，建议将useJUnit()替换为useJUnitPlatform()，因为Spock 2基于JUnit 5平台，兼容性更好。
• 确认测试类都在Gradle的test源集中，若使用单独的集成测试源集，需正确配置sourceSets。

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