Android项目从KAPT迁移到KSP后Room与Hilt生成文件编译错误

核心问题定位 #

生成代码出现var _argIndex: Int = ?这类无效语法，本质是Room、Hilt与KSP版本不兼容，或是依赖配置遗漏导致注解处理器生成代码逻辑异常。

具体修复步骤 #

1. 严格匹配Room与KSP版本兼容性 #

Room对KSP的支持有明确版本对应要求，比如Room 2.6.0+需要搭配KSP 1.9.0-1.0.12及以上版本。在项目根目录的build.gradle.kts（或.gradle）中统一管理版本：

// 根目录build.gradle.kts
val roomVersion = "2.6.1"
val kspVersion = "1.9.20-1.0.14"

2. 修正Room的KSP依赖配置 #

彻底移除Room相关的kapt依赖，全部替换为ksp：

// 模块build.gradle.kts
dependencies {
    implementation("androidx.room:room-runtime:$roomVersion")
    implementation("androidx.room:room-ktx:$roomVersion")
    ksp("androidx.room:room-compiler:$roomVersion") // 必须用ksp，禁止保留kapt配置
}

3. 检查Hilt与KSP的兼容配置 #

Hilt从2.48版本开始支持KSP，确保Hilt版本≥2.48，同时替换kapt依赖为ksp：

// 模块build.gradle.kts
dependencies {
    implementation("com.google.dagger:hilt-android:2.50")
    ksp("com.google.dagger:hilt-android-compiler:2.50")
}

// 根目录build.gradle.kts插件配置
plugins {
    id("com.google.devtools.ksp") version kspVersion apply false
    id("com.google.dagger.hilt.android") version "2.50" apply false
}

4. 彻底清理构建缓存 #

常规清理无效时，执行以下操作：

• 终端运行./gradlew clean（Windows系统用gradlew clean）
• 删除项目根目录下的.gradle文件夹（注意不是模块内的build文件夹）
• 重启Android Studio，选择File > Invalidate Caches... > Invalidate and Restart

5. 对齐Kotlin与KSP版本 #

KSP版本必须和项目使用的Kotlin版本严格匹配（版本号前半段完全一致），比如Kotlin 1.9.20对应KSP 1.9.20-1.0.14，在根目录配置中确认：

plugins {
    kotlin("android") version "1.9.20" apply false
}

6. 排查Compose插件冲突 #

新增Compose插件后，确认Compose BOM版本与compileSdk 35兼容，比如使用2024.02.00版本：

implementation(platform("androidx.compose:compose-bom:2024.02.00"))

验证方法 #

修改配置后，先执行./gradlew kspDebugKotlin命令查看KSP相关错误输出；再执行全量构建，检查生成的ToDoDao_Impl.kt文件中是否还存在var _argIndex: Int = ?这类无效语法。

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