本文详解 mockito 在 android 环境下无法模拟类的根本原因（kotlin 默认 final + android api 34 的兼容性问题），并提供从类声明、依赖配置到构建版本的完整解决方案。
本文详解 mockito 在 android 环境下无法模拟类的根本原因（kotlin 默认 final + android api 34 的兼容性问题），并提供从类声明、依赖配置到构建版本的完整解决方案。
在 Android 单元测试中使用 Mockito 模拟 Kotlin 类时，开发者常遇到如下错误：
org.mockito.exceptions.base.MockitoException: Mockito cannot mock this class: class com.test.test.Data Mockito can only mock non-private & non-final classes.
尽管你已为 Kotlin 类显式添加 open 关键字（如 open class Data），甚至尝试了纯 Java 类，问题仍持续存在——这往往并非代码层面的疏漏，而是环境兼容性问题。
✅ 正确解决路径
1. Kotlin 类必须 open，且成员也需开放
Kotlin 类默认 final，必须显式声明为 open；同时，若需 mock 其方法，方法本身也需 open（或用 open 修饰符覆盖默认行为）：
open class Data {
open fun fetchData(): String = "real data"
}⚠️ 注意：仅类
open不够——fetchData()若未声明为open，Mockito 仍无法重写该方法。
2. 使用 mockito-inline（必需）
标准 mockito-core 无法突破 JVM 的 final 限制，必须启用字节码增强能力。确保仅使用 mockito-inline（而非同时引入 mockito-core），并排除冲突依赖：
// ✅ 正确配置（testImplementation 仅需 inline） testImplementation 'org.mockito:mockito-inline:5.12.0' // 推荐使用较新稳定版 // ❌ 移除以下行（避免 core 与 inline 冲突） // testImplementation 'org.mockito:mockito-core:5.4.0'
? 提示：
mockito-android仅用于androidTest（Instrumented Test），纯单元测试（test）应使用mockito-inline。
3. 关键修复：Android Gradle Plugin 与 Target SDK 兼容性
根本原因在于：Mockito Inline 在 Android Gradle Plugin 8.2+（对应 targetSdk 34）中因 R8/AGP 字节码处理变更而失效。
即使配置无误，targetSdkVersion 34 会导致 mockito-inline 的 ByteBuddy 无法成功重写类字节码，从而抛出“cannot mock final class”错误。
✅ 解决方案：临时降级 targetSdkVersion 至 33（开发/测试阶段可行）：
android {
compileSdk 34
defaultConfig {
targetSdk 33 // ← 关键：改为 33
// ...
}
}? 验证方式：执行
./gradlew testDebugUnitTest --info，观察是否出现ByteBuddy redefinition failed相关日志。若存在，即确认为 AGP 34 兼容性问题。
4. 替代方案（长期推荐）
- ✅ 迁移至 MockK：专为 Kotlin 设计，原生支持
final类、协程、挂起函数，无需open关键字，且完全兼容 API 34+。 - ✅ 启用
@MockkConstructor或 接口抽象：将待测逻辑抽离至接口，用open实现类配合 Mockito，或直接 mock 接口（无需 inline）。
总结
Mockito 在 Android 单元测试中模拟 Kotlin 类失败，通常不是“没加 open”，而是三重因素叠加：
① Kotlin 类/方法未正确开放；
② 未使用 mockito-inline 或存在依赖冲突；
③ targetSdkVersion ≥ 34 引发的底层字节码注入失败（最易被忽略）。
优先检查 build.gradle 中的 targetSdk 和 mockito-inline 单一依赖，即可快速定位并解决 90% 的此类问题。
