Android Instrumentation测试中Mockito 2插件初始化失败求助

这个错误我之前帮不少开发者排查过，核心原因是Mockito 2默认的字节码生成机制（Byte Buddy）和Android Instrumentation测试的类加载环境不兼容，导致MockMaker插件无法正常初始化。下面是几个经过验证的解决方案，按优先级从高到低排序：

1. 改用Mockito Android专用依赖 #

最直接的解决方式是替换掉普通的mockito-core，使用专门适配Android测试环境的mockito-android。这个版本内置了针对Android优化的MockMaker（基于Dexmaker），能完美兼容Instrumentation测试。

修改你的Gradle依赖配置：

// 移除原来的mockito-core依赖
// androidTestImplementation 'org.mockito:mockito-core:2.x.x'

// 添加mockito-android依赖（建议使用最新的兼容版本）
androidTestImplementation 'org.mockito:mockito-android:2.28.2'

2. 显式指定Android专属MockMaker #

如果你已经在用mockito-android但依然报错，或者因为某些原因无法更换依赖，可以手动指定MockMaker实现：

• 在你的Android测试模块下创建目录结构：src/androidTest/resources/mockito-extensions
• 在该目录下创建一个名为org.mockito.plugins.MockMaker的文件
• 文件内只需要写入一行内容：

org.mockito.android.plugins.MockMaker

这会强制Mockito使用Android专用的MockMaker，绕过默认的Byte Buddy实现。

3. 排查并解决依赖冲突 #

有时候错误是因为其他测试库（比如Espresso）引入了冲突的Mockito或Byte Buddy版本。你可以通过Gradle命令查看依赖树：

./gradlew app:dependencies

找到冲突的依赖后，在对应的依赖声明中排除冲突组。比如排除Espresso中的Mockito依赖：

androidTestImplementation('androidx.test.espresso:espresso-core:3.4.0') {
    exclude group: 'org.mockito'
}

4. 确保测试类初始化方式正确 #

在Instrumentation测试中，不要直接使用MockitoAnnotations.initMocks(this)来初始化Mock对象，推荐结合AndroidJUnit4 runner和MockitoRule来管理Mock的生命周期：

@RunWith(AndroidJUnit4.class)
public class MyInstrumentedTest {
    @Rule
    public MockitoRule mockitoRule = MockitoJUnit.rule();

    @Mock
    private MyBusinessLogic mockLogic;

    @Test
    public void testSomething() {
        // 测试逻辑...
        when(mockLogic.calculate()).thenReturn(100);
        // 断言...
    }
}

这种方式能确保Mockito在Android测试环境下正确初始化，避免类加载时机的问题。

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