Room数据库Dao与RoomDatabase类重复类编译失败问题求助

问题根源分析 #

1. 重复注解处理器冲突：同时通过kapt、ksp、annotationProcessor三种方式引入Room编译器，导致Room注解处理器被多次执行，分别在ksp和kapt生成目录下生成了重复的AppDatabase_Impl和NoteDao_Impl类，触发重复类编译错误。
2. 类型不匹配引发擦除冲突：Note实体的uid字段为Long类型，但NoteDao中getNoteByUid方法的参数是Int类型，不仅会导致方法签名擦除后与其他方法产生冲突，还会造成数据库查询时的类型不兼容问题。

解决方案 #

1. 清理重复的注解处理器依赖 #

Room编译器只需通过一种注解处理器方式引入，推荐使用KSP（Kotlin Symbol Processing），它比kapt编译速度更快：

• 打开Module级别的build.gradle.kts（或build.gradle），移除kapt和annotationProcessor对应的Room编译器依赖，仅保留ksp版本：

  // 移除以下两行重复依赖
  // kapt "androidx.room:room-compiler:2.4.3"
  // annotationProcessor "androidx.room:room-compiler:2.4.3"
  
  // 仅保留ksp依赖
  ksp "androidx.room:room-compiler:2.4.3"
  

• 确保项目已配置KSP插件（版本需与Kotlin版本匹配），在Module的build.gradle（或build.gradle.kts）的plugins块中添加：

  plugins {
      id 'com.android.application'
      id 'org.jetbrains.kotlin.android'
      id 'com.google.devtools.ksp' version '1.7.10-1.0.6' // 替换为与你的Kotlin版本匹配的KSP版本
  }
  

2. 修正类型不匹配问题 #

将NoteDao中getNoteByUid方法的参数类型改为Long，与Note实体的uid字段类型保持一致，同时建议返回可空类型避免运行时崩溃：

@Dao
interface NoteDao {
    // ... 其他方法不变
    @Query("SELECT * FROM notes WHERE uid = :uid")
    suspend fun getNoteByUid(uid: Long): Note? // 修改参数类型为Long，返回可空类型
    // ... 其他方法不变
}

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

• 在Android Studio中执行：Build -> Clean Project，随后执行Build -> Rebuild Project。
• 或通过命令行执行：

  # macOS/Linux
  ./gradlew clean build
  
  # Windows
  gradlew clean build
  

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