Android Studio配置Room时kapt与ksp引用未解决问题求助

我近期学习Android Studio Kotlin编程，掌握基础语言和UI开发后开始学习Room本地数据库。参考教程配置build.gradle.kts（Module:app）时遇到了Unresolved reference kapt和Unresolved reference ksp错误，项目是仅修改该配置文件的新项目，配置代码如下：

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

android {
    namespace = "com.example.useofroomdatabase"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.useofroomdatabase"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
        vectorDrawables {
            useSupportLibrary = true
        }
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    buildFeatures {
        compose = true
    }
    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.1"
    }
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
        }
    }
}

dependencies {

    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
    implementation("androidx.activity:activity-compose:1.8.2")
    implementation(platform("androidx.compose:compose-bom:2023.08.00"))
    implementation("androidx.compose.ui:ui")
    implementation("androidx.compose.ui:ui-graphics")
    implementation("androidx.compose.ui:ui-tooling-preview")
    implementation("androidx.compose.material3:material3")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
    androidTestImplementation(platform("androidx.compose:compose-bom:2023.08.00"))
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-tooling")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    val room_version = "2.6.1"

    implementation("androidx.room:room-runtime:$room_version")
    annotationProcessor("androidx.room:room-compiler:$room_version")

    // To use Kotlin annotation processing tool (kapt)
    kapt("androidx.room:room-compiler:$room_version")
    // To use Kotlin Symbol Processing (KSP)
    ksp("androidx.room:room-compiler:$room_version")

    // optional - Kotlin Extensions and Coroutines support for Room
    implementation("androidx.room:room-ktx:$room_version")

    // optional - RxJava2 support for Room
    implementation("androidx.room:room-rxjava2:$room_version")

    // optional - RxJava3 support for Room
    implementation("androidx.room:room-rxjava3:$room_version")

    // optional - Guava support for Room, including Optional and ListenableFuture
    implementation("androidx.room:room-guava:$room_version")

    // optional - Test helpers
    testImplementation("androidx.room:room-testing:$room_version")

    // optional - Paging 3 Integration
    implementation("androidx.room:room-paging:$room_version")
}

我有两个问题：一是kapt和ksp这两个工具的作用是什么？二是我的代码中存在什么问题，该如何解决以继续学习？

补充：已解决kapt的引用问题，但ksp仍报错，推测可能与版本兼容性有关。

一、kapt 和 KSP 的作用 #

• kapt：全称Kotlin Annotation Processing Tool，是JetBrains推出的适配Kotlin的注解处理器。Room通过@Dao、@Database等注解标记类，kapt会扫描这些注解，自动生成对应的数据库操作实现代码，省去手动编写SQL模板代码的工作量，让开发者更专注于业务逻辑。
• KSP：全称Kotlin Symbol Processing，是Google推出的新一代注解处理工具，性能比kapt更优——它直接操作Kotlin的语法符号树，不需要先将Kotlin代码转成Java再处理，编译速度更快，现在是官方推荐替代kapt的方案，功能上和kapt一致，都是用来处理Room注解生成代码。

二、代码中的问题与解决方法 #

核心问题 #

你没有在plugins块中引入KSP插件，这是Unresolved reference ksp报错的直接原因；另外，同时添加了annotationProcessor、kapt、ksp三个同类注解处理器，会造成冗余甚至冲突。

解决步骤 #

1. 引入KSP插件
   在Module级build.gradle.kts的plugins块中添加KSP插件，注意插件版本必须和项目使用的Kotlin版本严格匹配（比如Kotlin版本为1.9.0，对应KSP版本为1.9.0-1.0.13，版本格式为${Kotlin版本}-1.0.x）。修改后的plugins块如下：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.devtools.ksp") version "1.9.0-1.0.13" // 替换为你的Kotlin版本对应的KSP版本
}

2. 清理冗余的注解处理器依赖
   annotationProcessor、kapt、ksp是同类工具，三选一即可，推荐使用KSP。如果选择KSP，删掉annotationProcessor和kapt的相关行，Room依赖部分修改为：

val room_version = "2.6.1"

implementation("androidx.room:room-runtime:$room_version")
// 仅保留ksp，删除另外两个注解处理器依赖
ksp("androidx.room:room-compiler:$room_version")

// optional - Kotlin Extensions and Coroutines support for Room
implementation("androidx.room:room-ktx:$room_version")

// 其他可选依赖按需保留即可

3. 检查版本兼容性

• 确认KSP版本与项目Kotlin版本完全对应：可以在Android Studio的File > Project Structure > Modules中查看当前Kotlin版本，再匹配对应的KSP版本。
• Room 2.6.1完全支持KSP，版本本身无兼容性问题，重点确保KSP插件版本正确。

4. 同步并重建项目
   修改完配置后，点击右上角的「Sync Now」同步项目，然后执行Build > Clean Project和Build > Rebuild Project清除缓存，重新构建即可。

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