使用JUnit5的Spock单元测试中@Rule注解未生效问题咨询

问题触发原因 #

你遇到的@Rule不生效问题核心原因是JUnit5原生不支持JUnit4的@Rule扩展机制，且适配JUnit5平台的Spock 2.x版本默认也没有内置JUnit4 Rule的兼容逻辑：

1. JUnit5采用了全新的Extension扩展模型，完全替换了JUnit4的Rule/Runner体系，原生不会识别和处理@Rule、@ClassRule这类JUnit4专属注解
2. 如果你当前使用的是Spock 2.x版本（适配JUnit5平台的版本），默认不会扫描测试类中的@Rule注解执行对应的生命周期逻辑，只有旧版Spock 1.x（适配JUnit4）才会原生支持@Rule

JUnit4与JUnit5的@Rule支持逻辑差异 #

• JUnit4中@Rule是官方标准扩展方式，分为方法级Rule和类级@ClassRule，测试Runner会自动扫描测试类中带@Rule注解的字段，在测试方法执行前后插入Rule对应的拦截逻辑
• JUnit5完全废弃了Rule体系，改用ExtensionAPI作为统一扩展入口，所有扩展需要通过@ExtendWith注解注册，没有内置对@Rule的处理逻辑
• 仅当你引入junit-vintage-engine依赖运行JUnit4风格的测试用例时，才会处理@Rule注解，该兼容逻辑不覆盖JUnit5、Spock 2.x风格的测试类

替代解决方案 #

方案1：Spock生命周期手动管理（最快适配，无额外依赖） #

直接利用Spock自带的setup/cleanup生命周期方法手动触发LogSpy的初始化和销毁逻辑，不需要修改LogSpy本身的代码，示例如下：

class LogTestSpec extends Specification {
    LogSpy logSpy = new LogSpy()

    def setup() {
        // 对应JUnit4 @Rule的before执行逻辑，方法名根据LogSpy的实际实现调整
        logSpy.startCapture()
    }

    def cleanup() {
        // 对应JUnit4 @Rule的after执行逻辑，方法名根据LogSpy的实际实现调整
        logSpy.stopCapture()
    }

    def "校验业务操作输出的日志"() {
        when:
        businessService.doSomething()

        then:
        logSpy.getInfoLogs().contains("操作执行成功")
    }
}

方案2：使用JUnit5官方迁移兼容模块 #

如果你希望保留@Rule的写法，可以引入JUnit5官方提供的迁移支持模块，开启Rule兼容能力：

1. 引入依赖junit-jupiter-migrationsupport（对应你项目的构建工具引入对应坐标即可）
2. 在测试类上添加@EnableRuleMigrationSupport注解，原有@Rule的代码不需要修改，示例如下：

import org.junit.jupiter.migrationsupport.rules.EnableRuleMigrationSupport

@EnableRuleMigrationSupport
class LogTestSpec extends Specification {
    @Rule
    public LogSpy logSpy = new LogSpy()

    // 原有测试用例保持不变
}

方案3：改造为Spock/JUnit5原生扩展（长期最优） #

如果后续全量切换到JUnit5体系，建议将LogSpy改造为适配Spock IExtension或者JUnit5 Extension的实现，完全脱离兼容层，性能和稳定性更好。

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