Android Kotlin项目构建报错：NoSuchMethodError（Room迁移KSP后）

问题场景 #

在Android Kotlin项目（Kotlin 1.9.23）中，将Room的注解处理器从kapt迁移至KSP后，触发如下构建错误：

错误 -
java.lang.NoSuchMethodError: 'void org.jetbrains.kotlin.incremental.IncrementalCompilationContext.(org.jetbrains.kotlin.incremental.storage.FileToPathConverter, org.jetbrains.kotlin.incremental.storage.FileToPathConverter, boolean, org.jetbrains.kotlin.incremental.CompilationTransaction, org.jetbrains.kotlin.build.report.ICReporter, boolean, boolean, int, kotlin.jvm.internal.DefaultConstructorMarker)'

项目相关配置如下：

composeOptions {
  kotlinCompilerExtensionVersion = "1.5.11"
}

kotlin {
  jvmToolchain {
      languageVersion.set(JavaLanguageVersion.of(1_8))
   }
}

kotlinOptions {
   jvmTarget = "18"
}

已尝试配置jvmToolchain，但问题未解决。

解决方案 #

1. 对齐KSP、Kotlin与Room的版本兼容性 #

KSP版本必须与Kotlin版本严格匹配，同时Room版本也需要适配当前KSP和Kotlin版本：

• Kotlin 1.9.23对应的KSP版本为1.9.23-1.0.17
• Room建议使用2.6.1及以上版本，确保支持KSP且与当前Kotlin版本兼容

在项目根目录的build.gradle中更新KSP依赖：

plugins {
    id 'com.google.devtools.ksp' version '1.9.23-1.0.17' apply false
}

在模块的build.gradle中更新Room依赖：

dependencies {
    implementation "androidx.room:room-runtime:2.6.1"
    ksp "androidx.room:room-compiler:2.6.1"
    // 其他Room相关依赖（如room-ktx）保持版本一致
}

2. 统一JVM版本配置 #

当前配置中jvmToolchain设置为Java 8，但kotlinOptions.jvmTarget为18，版本不一致会导致编译上下文冲突。统一设置为同一版本（推荐Java 17，适配现代Android开发与Kotlin 1.9）：

kotlin {
    jvmToolchain {
        languageVersion.set(JavaLanguageVersion.of(17))
    }
}

kotlinOptions {
    jvmTarget = "17"
}

3. 清理构建缓存并重新构建 #

旧的编译缓存可能残留不兼容的类文件，执行以下命令彻底清理后重新构建：

./gradlew clean build --no-build-cache

4. 验证Compose Compiler版本兼容性 #

Compose Compiler 1.5.11与Kotlin 1.9.23兼容，若仍有问题可尝试升级至适配Kotlin 1.9的最新稳定版：

composeOptions {
    kotlinCompilerExtensionVersion = "1.5.12"
}

错误原因 #

该错误源于KSP、Kotlin、Room或Compose Compiler之间的版本不匹配：Kotlin 1.9对增量编译上下文（IncrementalCompilationContext）的构造方法做了变更，若KSP版本未同步更新，就会调用不存在的构造方法，触发NoSuchMethodError。

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