Android中Kotlin版本不兼容问题咨询及配置说明

问题根源 #

你的项目配置的Kotlin插件版本是1.7.0，但依赖库（比如Hilt 2.50、Compose 1.6.2）自动引入了更高版本的Kotlin标准库（1.9.20），导致编译时元数据版本不匹配（预期1.7.1，实际1.9.0）。

解决方案 #

1. 升级项目级Kotlin插件版本并统一Hilt版本 #

修改项目根目录下的build.gradle文件：

buildscript {
    ext {
        compose_ui_version = '1.6.2'
    }
    dependencies {
        // 统一Hilt插件版本与依赖库版本一致
        classpath "com.google.dagger:hilt-android-gradle-plugin:2.50"
    }
}
// 顶级构建文件，可添加适用于所有子项目/模块的通用配置选项。
plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.android.library' version '7.4.2' apply false
    // 升级Kotlin插件到1.9.20，匹配依赖库的标准库版本
    id 'org.jetbrains.kotlin.android' version '1.9.20' apply false
}

2. 修正Compose Compiler版本 #

Compose UI与Compiler版本有严格对应关系，Compose 1.6.2需要搭配Compiler 1.5.3，而该版本要求Kotlin 1.9.20。修改应用模块下的build.gradle：

composeOptions {
    kotlinCompilerExtensionVersion '1.5.3'
}

3. 同步项目并清理缓存 #

• 点击Android Studio右上角的Sync Project with Gradle Files按钮同步配置
• 清理缓存：依次点击File → Invalidate Caches... → 勾选Invalidate and Restart，重启IDE

关键说明 #

• Kotlin插件版本必须与项目中所有依赖引入的Kotlin标准库版本保持一致，否则会触发元数据不兼容错误
• Compose Compiler版本不能随意指定，必须遵循官方的版本对应关系，否则会导致编译失败或运行异常
• Hilt的Gradle插件版本必须与hilt-android库版本完全一致，避免版本冲突

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