如何为Jetpack Compose Android应用正确添加Room Persistence依赖并解决报错

一、核心问题分析 #

• kapt报错Type mismatch. Required: KaptOptions Found: String：多因kapt插件未正确应用，或依赖声明写法有误
• ksp报错Unresolved reference: ksp：KSP插件配置不完整（版本与Kotlin不匹配、项目级未配置仓库、模块级未应用插件）

二、正确配置步骤（Kotlin DSL） #

1. 项目级build.gradle.kts配置 #

确保添加KSP插件的版本声明与仓库配置：

plugins {
    id("com.android.application") version "8.1.0" apply false
    id("org.jetbrains.kotlin.android") version "1.8.21" apply false
    // KSP版本需与Kotlin版本前半段完全匹配
    id("com.google.devtools.ksp") version "1.8.21-1.0.11" apply false
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

2. 模块级build.gradle.kts配置 #

第一步：正确应用插件

删除无效的id("androidx.room.room-compiler")，按需选择kapt或ksp插件：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    // 二选一：使用kapt则添加此插件
    kotlin("kapt")
    // 二选一：使用ksp则添加此插件
    id("com.google.devtools.ksp")
}

第二步：添加Room依赖（二选一）

禁止同时使用annotationProcessor、kapt、ksp三种方式引入room-compiler，选其一即可：

选项A：使用kapt

val room_version = "2.5.2"

implementation("androidx.room:room-runtime:$room_version")
kapt("androidx.room:room-compiler:$room_version")
// 可选：Room的Kotlin扩展与协程支持
implementation("androidx.room:room-ktx:$room_version")

选项B：使用ksp

val room_version = "2.5.2"

implementation("androidx.room:room-runtime:$room_version")
ksp("androidx.room:room-compiler:$room_version")
// 可选：Room的Kotlin扩展与协程支持
implementation("androidx.room:room-ktx:$room_version")

三、关键注意事项 #

• KSP版本必须与项目使用的Kotlin版本前半段完全一致，否则会出现兼容性问题
• 不要同时启用kapt和ksp，两者为同类注解处理器，同时使用会引发冲突
• 配置完成后，建议清理缓存并重启Android Studio：File -> Invalidate Caches... -> Invalidate and Restart

内容的提问来源于stack exchange，提问作者Michael Appiah-kubi