Android Kotlin项目添加Room依赖时遇ksp()方法找不到错误求助

刚入门基于Kotlin的Android开发，正在制作一个用于学习的笔记应用，计划使用Room存储笔记数据。参考官方教程添加Module的build.gradle依赖后，遇到无法解决的错误：

Could not find method ksp() for arguments [androidx.room:room-compiler:2.4.3] on object of type org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler

此前遇到过类似的kapt错误，通过在Module的build.gradle中添加对应插件解决，但这次的ksp问题尚未解决，目前已暂时移除ksp相关代码继续测试，希望得到解决方法。

相关代码 #

官方教程中的Room依赖示例 #

dependencies {
    val room_version = "2.4.3"

    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")
}

我的Module的build.gradle #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-android'
    id 'kotlin-kapt'

}
android {
    namespace 'android.example.mynotes'
    compileSdk 32

    defaultConfig {
        applicationId "android.example.mynotes"
        minSdk 21
        targetSdk 32
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled 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'
    }
}

dependencies {
    implementation 'androidx.core:core-ktx:1.7.0'
    implementation 'androidx.appcompat:appcompat:1.5.1'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

    def room_version = "2.4.3"
    implementation "androidx.room:room-runtime:$room_version"
    annotationProcessor "androidx.room:room-compiler:$room_version"
    implementation "androidx.room:room-rxjava2:$room_version"
    implementation "androidx.room:room-rxjava3:$room_version"
    implementation "androidx.room:room-guava:$room_version"
    testImplementation "androidx.room:room-testing:$room_version"

    implementation("com.google.devtools.ksp:symbol-processing-api:1.8.0-1.0.8")

    kapt "androidx.room:room-compiler:$room_version"
    ksp("androidx.room:room-compiler:$room_version")

}

我的Project的build.gradle #

plugins {
    id 'com.android.application' version '7.3.1' apply false
    id 'com.android.library' version '7.3.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.20' apply false
}

这个错误的核心原因是未在Module的build.gradle中添加KSP插件——和你之前解决kapt错误的逻辑一致，kapt需要kotlin-kapt插件，ksp则需要对应的KSP插件。具体修复步骤如下：

1. 在Project级build.gradle中添加KSP插件的classpath
   修改Project的build.gradle，添加KSP插件的版本声明，注意版本要和你当前使用的Kotlin版本（1.7.20）匹配：

   plugins {
       id 'com.android.application' version '7.3.1' apply false
       id 'com.android.library' version '7.3.1' apply false
       id 'org.jetbrains.kotlin.android' version '1.7.20' apply false
       // 添加KSP插件配置
       id 'com.google.devtools.ksp' version '1.7.20-1.0.8' apply false
   }
   

   KSP版本规则为[Kotlin版本]-[KSP核心版本]，必须保证Kotlin版本和KSP的前缀版本完全一致，否则会出现兼容性问题。

2. 在Module级build.gradle中应用KSP插件
   在Module的plugins块中添加KSP插件：

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
       id 'kotlin-android'
       id 'kotlin-kapt'
       // 应用KSP插件
       id 'com.google.devtools.ksp'
   }
   

3. 优化依赖配置（可选）

   • 如果你选择使用KSP，无需同时保留annotationProcessor和kapt依赖，只保留ksp即可，避免重复配置；
   • 你添加的com.google.devtools.ksp:symbol-processing-api依赖可移除，因为应用KSP插件后会自动引入相关依赖。

优化后的Module dependencies示例：

def room_version = "2.4.3"
implementation "androidx.room:room-runtime:$room_version"
// 仅保留ksp依赖即可
ksp "androidx.room:room-compiler:$room_version"
// 按需保留其他Room可选依赖
implementation "androidx.room:room-ktx:$room_version"
implementation "androidx.room:room-rxjava2:$room_version"
implementation "androidx.room:room-rxjava3:$room_version"
implementation "androidx.room:room-guava:$room_version"
testImplementation "androidx.room:room-testing:$room_version"

4. 同步Gradle配置
   点击Android Studio右上角的「Sync Now」按钮完成同步，错误即可解决。

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