Groovy环境下使用Mockito对spy对象打桩抛出WrongTypeOfReturnValue异常

你遇到的报错不是打桩语法错误，本质是 Java 原生 Mockito 与 Groovy 动态对象的方法识别错位问题。

• Groovy 类默认实现GroovyObject接口，会自动附带getMetaClass()、setMetaClass()等固定元方法，这类方法的返回值是强类型的MetaClass对象
• Java 版 Mockito 对 Groovy 对象做 spy 打桩时，依赖Java反射匹配方法签名的逻辑，会和 Groovy 运行时的动态调用路由错位：当你写doReturn(true).when(mc).somethingExists()时，Mockito 代理层实际拦截到的是Groovy 内部触发的getMetaClass()调用，根本没有绑定到你想要打桩的somethingExists()方法
• 最终 Mockito 把你传入的true返回值，硬塞给了需要返回MetaClass的getMetaClass()方法，就抛出了“Boolean 无法被 getMetaClass() 返回”的类型不匹配异常

1. 换用 Groovy 生态兼容的打桩工具（最省心） #

不要直接调用 Java 版的Mockito.spy()，换成针对 Groovy 动态特性做过适配的打桩实现，从根源避免方法识别错位：

• 使用 Groovy/Spock 生态自带的GroovySpy，这类实现专门处理了Groovy元方法的路由逻辑，不会出现打桩绑定错位的问题
  参考实现代码：

  import spock.lang.Specification
  class MyClassTest extends Specification {
      def "验证doSomething分支逻辑"() {
          given:
          def run = [number: 1] as Map
          def mc = GroovySpy(MyClass, constructorArgs: [run]) {
              somethingExists() >> true
          }
  
          when:
          def result = mc.doSomething()
  
          then:
          result == "foo"
      }
  }
  

2. 保留现有 Java 版 Mockito 时的修正方式 #

如果不想引入额外依赖，可以通过调整打桩写法，让 Mockito 正确绑定目标方法，避免路由错位：

• 不要使用无前置触发的doReturn写法，打桩时显式触发一次方法调用路径，让Groovy正确路由到目标方法
  容易触发错位的写法：

  doReturn(true).when(mc).somethingExists()
  

  修正后的兼容写法：

  // 显式声明返回值类型，触发正确的方法路由
  when(mc.somethingExists() as Boolean).thenReturn(true)
  

  这种写法和你之前测试时发现的“替换原始方法为固定返回值后，when写法能正常运行”的逻辑一致：它会提前让Groovy动态引擎识别到somethingExists()的真实调用路径，不会错位到getMetaClass()。
• 注意：这种写法仍然会在打桩阶段触发一次原方法调用，如果原方法存在复杂依赖，需要做好前置的测试数据准备。

3. 零依赖的替代测试方案 #

如果不想处理Mockito和Groovy的兼容问题，可以调整被测类的结构，从代码层面降低测试耦合度：

• 把somethingExists()的内部逻辑抽成可外部替换的闭包成员，测试时直接替换闭包的返回值，完全不需要走Mockito打桩链路
  调整后的类结构参考：

  class MyClass {
      def run
      // 可外部替换的逻辑闭包，保留默认实现
      Closure<Boolean> somethingExistsLogic = { ->
          // 原somethingExists()的内部业务逻辑
      }
  
      boolean somethingExists() {
          return somethingExistsLogic.call()
      }
  
      String doSomething() {
          return somethingExists() ? "foo" : "bar"
      }
  }
  

  对应测试代码，完全不需要mock/spy：

  @Test
  void testDoSomething() {
      Map run = [number: 1]
      MyClass mc = new MyClass(run)
      // 直接替换闭包逻辑，没有工具兼容问题
      mc.somethingExistsLogic = { -> true }
  
      assertEquals("foo", mc.doSomething())
  }
  

补充说明：你之前尝试把返回值替换成Boolean.FALSE仍然报错，是因为问题根源根本不是原始类型和包装类型的不匹配——只要Mockito绑定错了目标方法，不管你传什么类型的返回值，都会触发对应的类型不匹配报错。

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