升级Kotlin Gradle插件至1.5.20后低版本Android设备出现IncompatibleClassChangeError

问题根源 #

该异常是Kotlin 1.5+ 顶层匿名类字节码生成逻辑变动，与Android 6.0及更低版本系统反射API的兼容性缺陷共同导致：
定义在Kotlin文件顶层的匿名LifecycleObserver实现类progressCleaner，在Kotlin 1.5+ 编译生成字节码时，类宿主标记逻辑发生了变更，Android 6.0及更低版本的Class.getCanonicalName()方法无法识别该标记，会尝试查找不存在的类初始化方法<clinit>，最终抛出IncompatibleClassChangeError。高版本Android系统修复了该反射逻辑缺陷，因此Android 10及以上设备运行正常。

解决方案 #

以下方案按优先度排序：

• 最优方案：将顶层匿名LifecycleObserver改为命名类实现，完全规避兼容性问题，仅需修改ProgressDialog.kt中progressCleaner的定义：

// 替换原有匿名对象的定义
private class ProgressCleaner : LifecycleObserver {
    @OnLifecycleEvent(Lifecycle.Event.ON_DESTROY)
    fun onDestroy(owner : LifecycleOwner) {
        ownerToProgressMap.remove(owner)?.dismiss()
        owner.lifecycle.removeObserver(this)
    }
}
private val progressCleaner = ProgressCleaner()

• 备选方案1：升级Androidx Lifecycle依赖到2.3.0及以上版本，高版本Lifecycle重构了观察者类型识别逻辑，不会调用getCanonicalName触发系统反射缺陷。
• 备选方案2：在模块级build.gradle的Kotlin编译配置中添加兼容参数，恢复Kotlin 1.4版本的内部类字节码生成逻辑：

kotlinOptions {
    freeCompilerArgs += ["-Xuse-old-innerClasses"]
}

该参数为临时兼容方案，后续Kotlin版本可能会移除，不建议长期使用。

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