Room框架编译报错：参数需为@Entity注解类或其集合/数组

问题详情 #

编译Android应用时触发以下错误：

error: Type of the parameter must be a class annotated with @Entity or a collection/array of it. kotlin.coroutines.Continuation<? super kotlin.Unit> $completion);

错误生成在build目录的自动生成文件中，无法直接编辑。已尝试升级Room版本、切换至KSP（因Hilt依赖Kapt只能回退），问题仍未解决。

提供的代码文件 #

build.gradle（模块级）

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    kotlin("kapt")
    id ("kotlin-kapt")
    id("com.google.dagger.hilt.android")
    id("kotlin-parcelize")
    id("androidx.navigation.safeargs")
    id("com.google.devtools.ksp")
}

android {
    namespace = "com.shubhamtripz.notebox"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.shubhamtripz.notebox"
        minSdk = 21
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }

    buildFeatures {
        viewBinding = true
    }
}

dependencies {
    implementation("androidx.core:core-ktx:1.10.1")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.9.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    implementation("androidx.navigation:navigation-fragment-ktx:2.7.1")
    implementation("androidx.navigation:navigation-ui-ktx:2.7.1")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
    implementation("com.google.dagger:hilt-android:2.48")
    kapt("com.google.dagger:hilt-android-compiler:2.48")

    val room_version = "2.5.2"
    implementation ("androidx.room:room-runtime:2.5.2")
    implementation ("androidx.room:room-ktx:2.5.2")
    kapt ("androidx.room:room-compiler:2.5.2")

    val lifecycle_version = "2.6.1"
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")
}

NoteDao.kt

package com.shubhamtripz.notebox.data.dao

import androidx.room.Dao
import androidx.room.Delete
import androidx.room.Insert
import androidx.room.Query
import androidx.room.Update
import com.shubhamtripz.notebox.data.entity.Note
import kotlinx.coroutines.flow.Flow

@Dao
interface NoteDao {
    @Query("select * from notes ORDER BY date desc")
    fun getAllNotes(): Flow<List<Note>>

    @Insert
    suspend fun insertNote(note: Note)

    @Update
    suspend fun updateNote(note: Note)

    @Delete
    suspend fun deleteNote(note: Note)
}

解决方案 #

1. 移除冲突的注解处理器插件 #

build.gradle中同时启用了kapt和ksp，这会导致Room注解处理冲突，生成错误代码。移除com.google.devtools.ksp插件，并清理重复的kapt声明：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    kotlin("kapt") // 保留一个kapt声明即可
    id("com.google.dagger.hilt.android")
    id("kotlin-parcelize")
    id("androidx.navigation.safeargs")
}

2. 验证Note实体类的@Entity注解 #

确保Note实体类正确添加了@Entity注解，且表名与Dao中的查询语句一致：

package com.shubhamtripz.notebox.data.entity

import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "notes") // 必须与Dao中查询的表名匹配
data class Note(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val title: String,
    val content: String,
    val date: Long
    // 按需添加其他字段
)

3. 清理并重新构建项目 #

• 执行Build -> Clean Project清理缓存
• 执行Build -> Rebuild Project重新编译
• 若仍有问题，手动删除项目根目录下的build文件夹和模块目录下的build文件夹，再重新构建

内容的提问来源于stack exchange，提问作者Shubham Kumar Mahato