Android Gradle中Unresolved reference: ksp错误修复求助

问题根源 #

你的配置里虽然在libs.versions.toml定义了KSP插件，但项目级build.gradle.kts未声明该插件的别名，同时模块级直接用id("com.google.devtools.ksp")引用，没利用版本目录的统一管理，导致Gradle无法识别ksp依赖配置。

修复步骤 #

1. 更新项目级build.gradle.kts #

在plugins块中添加KSP插件的别名声明，让Gradle能识别该插件：

plugins {
    alias(libs.plugins.androidApplication) apply false
    alias(libs.plugins.androidLibrary) apply false
    alias(libs.plugins.kotlinAndroid) apply false
    alias(libs.plugins.kotlinKsp) apply false // 新增这一行
}

2. 修正模块级build.gradle.kts的插件引用 #

把直接用id的方式改成别名引用，保持版本统一管理：

plugins {
    alias(libs.plugins.androidApplication)
    alias(libs.plugins.kotlinAndroid)
    id("androidx.navigation.safeargs.kotlin")
    alias(libs.plugins.kotlinKsp) // 替换原来的id("com.google.devtools.ksp")
}

3. 验证依赖配置 #

模块的dependencies中ksp(libs.room.compiler)这一行是正确的，保留即可，Room编译器通过KSP处理没问题。

4. 同步并清理构建 #

• 点击Android Studio右上角的「Sync Project with Gradle Files」按钮
• 依次执行「Build > Clean Project」和「Build > Rebuild Project」

额外注意事项 #

• 当前KSP版本1.9.0-1.0.12和Kotlin版本1.9.0是兼容的，无需修改
• settings.gradle.kts里已经配置了google()和mavenCentral()仓库，KSP插件能正常下载

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