Spock单元测试void方法验证出现调用次数不足问题

核心问题拆解 #

你遇到的两个现象本质是同一个问题：Spock的交互验证作用域错误，加上Gradle插件测试中Mock对象关联不到位，导致void方法的调用无法被捕获，甚至错误验证也能“假通过”。

问题根源 #

1. 回调内的验证不生效：pluginManager.withPlugin是回调式执行，如果你把1 * licenseeExtension.ignoreDependencies()写在回调内部，Spock不会将其当作交互验证——回调里的代码属于被测试逻辑的一部分，测试主线程不会等待回调完成，甚至如果回调没被执行，里面的验证代码根本不会运行，导致测试误判通过。
2. Mock对象未正确关联：如果插件内部获取的licenseeExtension不是你Mock的实例，自然无法捕获它的方法调用，就会出现Too few invocations错误。
3. Void方法的验证逻辑：Spock对void方法的验证不需要额外处理，只要确保Mock对象被正确调用，在then块中声明交互次数即可。

解决步骤 #

1. 正确Mock Gradle核心对象的依赖链 #

确保Project、PluginManager、ExtensionContainer、LicenseeExtension之间的关联完全打通，让插件代码能获取到你Mock的实例：

given:
def project = Mock(Project)
def pluginManager = Mock(PluginManager)
def extensionContainer = Mock(ExtensionContainer)
def licenseeExtension = Mock(LicenseeExtension)

// 关联Project与PluginManager
project.pluginManager >> pluginManager
// 关联Project与ExtensionContainer
project.extensions >> extensionContainer
// Stub插件应用后的回调执行，触发配置代码运行
pluginManager.withPlugin("com.github.jk1.license") >> { Closure configClosure ->
    configClosure.call()
}
// 根据插件获取extension的方式，Stub对应的ExtensionContainer方法
// 如果插件用project.extensions.getByName("licensee")
extensionContainer.getByName("licensee") >> licenseeExtension
// 如果插件用project.extensions.configure(LicenseeExtension)
extensionContainer.configure(LicenseeExtension, _) >> { _, Closure config ->
    config.call(licenseeExtension)
}

2. 所有交互验证放在then块 #

Spock的then块是专门用来验证Mock交互的，把所有验证逻辑移到这里，包括插件应用和void方法调用：

when:
new ThirdPartyLicensesCheckPlugin().apply(project)

then:
// 验证Licensee插件被应用
1 * pluginManager.apply("com.github.jk1.license")
// 验证ignoreDependencies方法被调用（根据实际参数调整匹配器）
1 * licenseeExtension.ignoreDependencies(["some-dependency"])
// 如果无参数，写1 * licenseeExtension.ignoreDependencies()

3. 避免Stub与验证分离的坑 #

你提到的“同一方法的Mock与Stub必须在同一交互中”，对于void方法来说，只要不在given块中对同一个方法同时做Stub和验证，而是把验证放在then块，就不会有问题——Stub是给被测试代码提供行为，验证是确认行为被触发，两者作用域分开就不会冲突。

完整测试示例 #

class ThirdPartyLicensesCheckPluginSpec extends Specification {

    def "verify Licensee plugin is applied and ignoreDependencies is called"() {
        given:
        def project = Mock(Project)
        def pluginManager = Mock(PluginManager)
        def extensionContainer = Mock(ExtensionContainer)
        def licenseeExtension = Mock(LicenseeExtension)

        project.pluginManager >> pluginManager
        project.extensions >> extensionContainer

        // 让withPlugin的回调执行，触发插件配置逻辑
        pluginManager.withPlugin("com.github.jk1.license") >> { Closure c -> c.call() }
        // 让插件能获取到Mock的extension
        extensionContainer.getByName("licensee") >> licenseeExtension

        when:
        new ThirdPartyLicensesCheckPlugin().apply(project)

        then:
        // 验证插件被应用
        1 * pluginManager.apply("com.github.jk1.license")
        // 验证void方法被调用
        1 * licenseeExtension.ignoreDependencies(["org.springframework:spring-core"])
    }
}

关键注意事项 #

• 不要在when块或回调内部写1 * ...这种交互验证，Spock只会识别then块中的验证规则。
• 务必根据插件内部获取extension的实际代码，选择StubgetByName还是configure方法，否则Mock的extension不会被插件代码拿到。
• 如果遇到参数匹配问题，可以用_匹配任意参数，比如1 * licenseeExtension.ignoreDependencies(_)，先确认方法被调用，再细化参数匹配。

内容的提问来源于stack exchange，提问作者Stuart Leyland-Cole