使用PowerMockito spy时为何抛出TooManyActualInvocations异常？

问题根源 #

• 版本不兼容：PowerMock 2.0.9版本要求配套的Mockito版本最低为2.23.0，你当前使用的Mockito 2.8.9版本过老，存在调用计数统计异常的已知bug
• Kotlin方法特性冲突：Kotlin类的方法默认使用final修饰，PowerMockito在代理final方法时会出现调用逻辑重复统计的问题，普通Mockito spy不会触发该问题是因为其默认不代理final方法，仅走真实调用逻辑且不统计final方法的调用次数
• API混用冲突：你使用Mockito原生的verify方法验证PowerMockito生成的spy对象，两个框架的调用计数逻辑不互通，导致统计结果异常

修复步骤 #

1. 调整依赖为互相兼容的版本：

testImplementation 'org.powermock:powermock-api-mockito2:2.0.9'
testImplementation 'org.mockito:mockito-core:2.23.4'
testImplementation "org.powermock:powermock-module-junit4:2.0.9"
testImplementation "org.powermock:powermock-core:2.0.9"

2. 处理Kotlin final方法的代理问题，二选一即可：
   • 给MyClass中需要被代理的方法（publicMethod1、publicMethod2）添加open修饰符
   • 在测试类上新增@SuppressFinalization(MyClass::class)注解，让PowerMock自动处理final方法的代理逻辑
3. 调整测试代码，统一使用PowerMockito的验证API：

@RunWith(PowerMockRunner::class)
@PrepareForTest(MyClass::class)
@SuppressFinalization(MyClass::class) // 若已给方法添加open修饰可省略该注解
class myObjectTest {
    @Test
    fun myTest(){
        val myObject = MyClass()
        val myObjectSpy  = PowerMockito.spy(myObject)
        
        myObjectSpy.publicMethod1()
        // 统一使用PowerMockito的验证方法
        PowerMockito.verify(myObjectSpy).publicMethod2()
        PowerMockito.verifyPrivate(myObjectSpy).invoke("myPrivateMethod3")
    }
}

完成以上调整后即可正常验证公共方法和私有方法的调用次数，不会再出现计数统计错误的问题。

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