Android集成Room、kapt、Hilt时kaptDebugKotlin任务执行失败求助

排查步骤及修复方案 #

1. 严格匹配依赖版本兼容性 #

Room、Hilt、Kotlin、AGP（Android Gradle Plugin）的版本必须对应兼容，版本不匹配是注解处理失败的常见原因：

• Room 2.5.0+ 需搭配 Kotlin 1.8.0+
• Hilt 2.44+ 适配 AGP 7.4+

建议在项目根build.gradle中统一管理版本：

ext {
    kotlin_version = "1.8.22"
    room_version = "2.5.2"
    hilt_version = "2.48"
    agp_version = "7.4.2"
}

2. 修正kapt及依赖配置 #

确保插件和依赖的引入顺序、配置项正确：
在app模块build.gradle中：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt'
    id 'dagger.hilt.android.plugin'
}

android {
    // 其他基础配置...
    defaultConfig {
        // 若需导出Room schema，配置路径
        kapt {
            arguments {
                arg("room.schemaLocation", "$projectDir/schemas")
            }
        }
    }
}

dependencies {
    // Room相关依赖
    implementation "androidx.room:room-runtime:$room_version"
    kapt "androidx.room:room-compiler:$room_version"
    implementation "androidx.room:room-ktx:$room_version"

    // Hilt相关依赖
    implementation "com.google.dagger:hilt-android:$hilt_version"
    kapt "com.google.dagger:hilt-android-compiler:$hilt_version"
}

3. 检查Room代码合法性 #

• 确认@Database注解的entities列表包含所有实体类，无遗漏或错误引用
• 实体类的@Entity注解配置正确，主键、索引、字段类型无语法问题
• DAO接口的@Query/@Insert等注解内SQL语句无拼写错误

示例正确的数据库类：

@Database(entities = [User::class], version = 1, exportSchema = true)
@TypeConverters(Converters::class)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}

4. 清理缓存并重建项目 #

执行Gradle命令彻底清理缓存后重建：

./gradlew clean
./gradlew assembleDebug

或在Android Studio中依次点击Build > Clean Project → Build > Rebuild Project

5. 定位InvocationTargetException根源 #

该异常是注解处理器内部抛出的包装异常，可通过查看Build工具窗口中:app:kaptDebugKotlin任务的完整日志，展开Caused by部分，找到具体错误（比如实体类字段不兼容、SQL语法错误等）

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