Room配合Kotlin协程时Dao类报错：参数需为@Entity注解类

在Android项目中使用Room框架时，用suspend修饰DAO层的数据库操作方法，编译阶段抛出如下错误：

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

涉及的核心代码如下：

Article实体类 #

@Entity(
    tableName = "articles"
)
@Parcelize
data class Article(
    @PrimaryKey(autoGenerate = true)
    var id: Int? = null,
    val author: String?,
    val content: String?,
    val description: String?,
    val publishedAt: String?,
    val source: Source?,
    val title: String?,
    val url: String?,
    val urlToImage: String?
) : Parcelable

Converters类型转换器 #

class Converters {
    @TypeConverter
    fun fromSource(source : Source) : String{
        return source.name
    }

    @TypeConverter
    fun toSource(name : String) : Source {
        return Source(name, name)
    }
}

ArticleDao接口 #

@Dao
interface ArticleDao {

    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun upsertArticle(article : Article) : Long

    @Query("SELECT * FROM articles")
    fun getAllArticles() : LiveData<List<Article>>

    @Delete
    suspend fun deleteArticle(article: Article)
}

ArticleDatabase数据库类 #

@Database(
    entities = [Article::class],
    version = 1
)
@TypeConverters(Converters::class)
abstract class ArticleDatabase : RoomDatabase(){

    abstract fun getArticleDao() : ArticleDao

    companion object{
        @Volatile
        private var instance: ArticleDatabase? = null
       
        private val LOCK = Any()

        operator fun invoke(context: Context) = instance ?: synchronized(LOCK) {
            instance ?: createDatase(context).also { instance = it }
        }
        
        private fun createDatase(context: Context) =
            Room.databaseBuilder(
                context.applicationContext,
                ArticleDatabase::class.java,
                "article_db.db"
            ).build()
    }
}

现有Room依赖配置 #

def roomVersion = "2.4.2"

implementation("androidx.room:room-runtime:$roomVersion")
annotationProcessor("androidx.room:room-compiler:$roomVersion")

// To use Kotlin annotation processing tool (kapt)
kapt("androidx.room:room-compiler:$roomVersion")
implementation("androidx.room:room-ktx:$roomVersion")

// optional - Kotlin Extensions and Coroutines support for Room
implementation("androidx.room:room-ktx:$roomVersion")

该报错的核心逻辑是Room的注解处理器未能正确识别Kotlin suspend 函数语法，将Kotlin编译器为协程自动注入的续体参数Continuation判定为DAO方法的业务入参，最终提示参数类型不符合@Entity的要求。
结合给出的配置，直接诱因是纯Kotlin项目下同时配置了annotationProcessor（Java注解处理器路径）和kapt（Kotlin注解处理器路径）来处理room-compiler，Java版注解处理器无法解析Kotlin协程语法，导致注解处理流程异常。另外配置中重复引入了两次room-ktx属于冗余配置，虽不直接触发报错，但也需要清理。

1. 移除模块级build.gradle中Java路径的Room注解处理器配置，即删除annotationProcessor("androidx.room:room-compiler:$roomVersion")这一行，Kotlin项目仅保留kapt路径的room-compiler即可。
2. 删除重复添加的implementation("androidx.room:room-ktx:$roomVersion")依赖，仅保留一行该依赖声明。
3. 检查模块级build.gradle顶部的插件配置，确认已启用kapt插件：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt' // 必须添加这行，kapt才能正常工作
}

4. 执行Gradle的clean任务清理旧构建缓存，再重新编译项目即可。

修正后的依赖参考配置：

def roomVersion = "2.4.2"

implementation("androidx.room:room-runtime:$roomVersion")
kapt("androidx.room:room-compiler:$roomVersion")
implementation("androidx.room:room-ktx:$roomVersion")

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