更新Compose库后构建报错：找不到androidx.compose.compiler:compiler:provider(?)

问题核心原因 #

报错源于Compose Compiler版本与Kotlin版本不匹配，且未正确显式配置Compiler依赖——Compose BOM不会自动管理Compiler版本，必须单独指定与当前Kotlin版本兼容的Compiler版本。

具体解决步骤 #

1. 显式添加兼容的Compose Compiler依赖

在你的依赖清单中添加对应版本的Compiler依赖，Kotlin 1.9.20需搭配Compose Compiler 1.5.4：

compose-compiler = { group = "androidx.compose.compiler", name = "compiler", version = "1.5.4" }

2. 同步Gradle配置中的Compiler版本

在模块级build.gradle.kts中，确保composeOptions里的版本与Compiler依赖一致：

android {
    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.4"
    }
}

同时确认已启用Compose插件：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("org.jetbrains.kotlin.plugin.compose")
}

3. 清理依赖缓存并重新构建

执行以下命令清理旧缓存并触发全新构建：

./gradlew clean build --refresh-dependencies

4. 排查潜在依赖冲突（可选）

如果仍有问题，检查是否有其他依赖引入了不兼容的Compiler版本，通过排除规则处理：

dependencies {
    // 示例：排除第三方依赖中的旧Compiler版本
    implementation("some.library:xyz:1.0.0") {
        exclude(group = "androidx.compose.compiler", module = "compiler")
    }
}

版本对应验证 #

确保你的版本组合符合官方兼容表：

• Kotlin 1.9.20 ↔ Compose Compiler 1.5.4
• Gradle 8.1.3 ↔ Compose 1.5.4 / BOM 2023.10.01

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