串行执行Spock测试套件触发Mockito参数匹配器异常，单测正常

问题根源 #

这个异常本质是前一个测试用例残留的Mockito参数匹配器状态污染了当前测试。Mockito的参数匹配器（比如any()、eq()）存储在线程本地，如果前序测试存在匹配器使用不规范（比如单独调用匹配器而非在when()/verify()中），或者测试结束后未清理mock状态，串行执行时下一个测试初始化mock的动作会触发Mockito校验逻辑，误以为你在错误位置使用了匹配器。

具体解决步骤 #

1. 规范参数匹配器的使用 #

检查所有测试类（尤其是当前测试之前执行的套件），确保参数匹配器只出现在when()的存根逻辑或verify()的验证逻辑中，禁止单独调用匹配器：

// 错误写法：单独调用匹配器，污染线程状态
def "bad test"() {
    given:
    def invalidArg = anyString() // 这里不能单独用匹配器

    // ...
}

// 正确写法：匹配器仅用于mock方法的参数
def "good test"() {
    given:
    when(exampleService.doSomething(anyString())).thenReturn(true)

    then:
    verify(exampleService).doSomething(eq("test"))
}

2. 每个测试前重新初始化mock并清理状态 #

不要在测试类的字段级别直接创建mock，而是移到Spock的setup()方法中初始化，同时在setup()或cleanup()中调用Mockito.reset()清理mock状态：

class MySecondTest extends Specification {
    ExampleService exampleService

    def setup() {
        // 每个测试方法前重新创建mock
        exampleService = Mockito.mock(ExampleService.class)
        // 强制清理残留的匹配器状态
        Mockito.reset(exampleService)
    }

    def cleanup() {
        // 测试结束后再次清理，避免影响下一个测试
        Mockito.reset(exampleService)
    }

    // 测试方法...
}

3. 使用@AutoCleanup自动清理mock #

给mock变量添加Spock的@AutoCleanup注解，确保测试结束后自动释放mock资源，避免状态残留：

class MySecondTest extends Specification {
    @AutoCleanup
    ExampleService exampleService = Mockito.mock(ExampleService.class)

    // 测试方法...
}

4. 放宽Mockito的严格检查（兜底方案） #

如果上述方法无效，可以在测试类上添加@MockitoSettings注解，降低Mockito的校验严格度：

import org.mockito.junit.jupiter.MockitoSettings
import org.mockito.quality.Strictness

@MockitoSettings(strictness = Strictness.LENIENT)
class MySecondTest extends Specification {
    // 测试代码...
}

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