Spock中Mock静态方法偶发InvalidUseOfMatchersException问题

这是静态方法Mock的全局状态污染导致的：

• StringImplUtils.emptyIfBlank是静态方法，CryptUtilTest2中对它的Mock会修改JVM全局的类状态
• 当多个测试类并行（或串行但未及时清理Mock）执行时，Mock的状态会泄露到CryptUtilTest1中：
  • 导致CryptUtil.test("123")调用了被Mock的方法返回null，触发断言失败
  • 残留的Mockito匹配器上下文未清空，偶发InvalidUseOfMatchersException
• 之前用Spock1.x+PowerMock无问题，是因为PowerMock默认会在每个测试类的setup/cleanup阶段自动清理静态Mock的全局状态，而当前测试环境未做这个隔离处理

1. 强制隔离静态Mock的作用域（推荐） #

如果使用Mockito 3.4+（Spock 2.x通常搭配该版本），用MockStatic的try-with-resources语法，确保Mock仅在当前测试方法生效，不会污染其他测试：

class CryptUtilTest2 extends Specification {
    def "test method that uses mocked emptyIfBlank"() {
        given:
        // 用try-with-resources包裹Mock，自动清理
        try (MockStatic<StringImplUtils> mockStatic = Mockito.mockStatic(StringImplUtils.class)) {
            mockStatic.when(() -> StringImplUtils.emptyIfBlank(anyString())).thenReturn("mocked-value")
            
            when:
            def result = CryptUtil.someMethodThatUsesEmptyIfBlank()
            
            then:
            result == "expected-result"
        } // 此处自动关闭Mock，恢复原方法逻辑
    }
}

2. 在测试类级别做Mock清理 #

如果必须在类级别初始化Mock，要在cleanupSpec中手动销毁静态Mock：

class CryptUtilTest2 extends Specification {
    private MockStatic<StringImplUtils> mockStatic

    def setupSpec() {
        mockStatic = Mockito.mockStatic(StringImplUtils.class)
        mockStatic.when(() -> StringImplUtils.emptyIfBlank(anyString())).thenReturn("mocked-value")
    }

    def cleanupSpec() {
        mockStatic.close() // 强制清理Mock，恢复原方法
    }

    // 测试方法...
}

3. 临时禁用测试并行执行（应急方案） #

如果暂时无法修改测试代码，可以关闭测试任务的并行执行，避免Mock状态交叉污染：

• Gradle：在build.gradle中添加

  test {
      parallel = false
  }
  

• Maven：在pom.xml的surefire插件中设置

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <configuration>
          <parallel>none</parallel>
      </configuration>
  </plugin>
  

4. 回归Spock1.x+PowerMock的隔离逻辑（兼容方案） #

如果要保持原有测试逻辑，确保PowerMock的@PrepareForTest和@PowerMockIgnore配置正确，并且每个测试类都通过PowerMock的规则自动清理静态Mock：

@RunWith(PowerMockRunner.class)
@PrepareForTest([StringImplUtils.class])
class CryptUtilTest2 extends Specification {
    def "test method"() {
        given:
        PowerMockito.mockStatic(StringImplUtils.class)
        PowerMockito.when(StringImplUtils.emptyIfBlank(anyString())).thenReturn("mocked-value")
        
        // 测试逻辑...
        
        then:
        // 断言...
        
        cleanup:
        PowerMockito.verifyStatic(StringImplUtils.class)
        // 可选：手动重置静态Mock
        PowerMockito.reset(StringImplUtils.class)
    }
}

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