Android Studio构建报错UnsupportedOperationException：未解析内部类

我之前维护Kotlin项目时也碰到过完全一样的问题——每次首次构建都会抛出UnsupportedOperationException: Unresolved local class，但执行Clean后就能正常编译，折腾了好一阵才找到根源和解决办法，分享给你：

快速解决方案 #

1. 禁用KAPT增量编译 #

这是最直接有效的办法，问题本质就是KAPT增量编译的缓存异常导致局部类解析失败。在你的模块build.gradle（如果用KTS就是build.gradle.kts）中添加以下配置：

android {
    // 其他配置...
    kapt {
        incremental = false
    }
}

关闭增量编译后，每次都会全量构建，虽然会稍微慢一点，但能彻底避免缓存导致的类解析问题。

2. 彻底清理缓存（临时应急） #

如果不想关闭增量编译，每次遇到错误时可以手动清理更彻底的缓存目录，比Android Studio自带的Clean更彻底：

• 删除app/build/tmp/kapt3目录（也就是错误日志里提到的被删除的增量数据目录）
• 删除项目根目录下的.gradle/caches
• 删除app/build/generated目录
  之后重启Android Studio再重新构建，基本能解决单次的构建失败问题。

3. 检查局部内部类的代码 #

错误提示的com/toppr/dubbio/v3/base/BaseSocketActivity$serviceConnection$1是一个匿名局部内部类，你可以检查这个类的实现：

• 是否在内部类中引用了外部类的非final变量？Kotlin对匿名内部类的变量捕获有严格要求，可能会导致编译元数据异常
• 如果这个类涉及到注解处理器（比如Room、Dagger），检查是否在注解标注的类中使用了过于复杂的内部类结构，部分注解处理器对Kotlin内部类的支持存在bug

问题根源 #

这个错误几乎都是KAPT增量编译的缓存bug导致的：Kotlin编译器在增量构建时，无法正确识别和复用之前构建生成的局部内部类的元数据，导致后续构建时找不到对应的类定义。而Clean操作会清空所有增量缓存，让编译器从头开始全量构建，所以能正常完成，但下次增量构建又会触发同样的问题。

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