Android Studio中正确导入Room库及注解错误排查

问题诊断 #

你遇到的Illegal annotation class 'Entity'和Unresolved reference 'PrimaryKey'错误，核心原因有三点：

• 缺失Room核心运行时依赖（room-runtime），实体类注解所在的核心包未被引入
• Room依赖版本不一致且配置重复
• 实体类注解的导入路径错误

修正步骤 #

1. 统一Room版本（修改libs.versions.toml）

将所有Room相关版本统一为同一稳定版（推荐使用最新稳定版，示例用2.8.4），删除冗余配置：

[versions]
# ...保留原有其他版本配置
roomVersion = "2.8.4"  # 新增统一Room版本

[libraries]
# ...保留原有其他库配置
androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "roomVersion" }
androidx-room-compiler = { module = "androidx.room:room-compiler", version.ref = "roomVersion" }
# 删除原有的`room-compiler`条目，避免重复依赖

2. 修正Module依赖（修改build.gradle.kts (Module: app)）

删除错误的implementation(libs.room.compiler)，添加Room核心运行时依赖，确保仅用KSP引用编译库：

dependencies {
    # ...保留原有其他依赖
    implementation(libs.androidx.room.runtime)  // 添加Room核心运行库
    ksp(libs.androidx.room.compiler)           // 仅通过KSP引用编译库，无需implementation
    # ...保留原有其他依赖
}

3. 修正实体类导入路径

实体类注解的导入路径错误，修正为Room官方标准包路径：

package com.example.counter.counter.data

import androidx.room.Entity  // 修正导入路径，移除多余的`.vo`
import androidx.room.PrimaryKey  // 新增PrimaryKey注解的导入

@Entity
data class Counter(
    @PrimaryKey val id: Int = 0,
    val count: Int
)

验证与后续配置 #

完成修改后点击Android Studio的Sync Project with Gradle Files同步项目，注解错误会自动消失。后续可补充完整Room配置示例：

// 数据库类示例
import androidx.room.Database
import androidx.room.RoomDatabase

@Database(entities = [Counter::class], version = 1)
abstract class CounterDatabase : RoomDatabase() {
    abstract fun counterDao(): CounterDao
}

// DAO接口示例
import androidx.room.Dao
import androidx.room.Query

@Dao
interface CounterDao {
    @Query("SELECT * FROM Counter WHERE id = 0")
    suspend fun getCounter(): Counter?

    @Query("UPDATE Counter SET count = :newCount WHERE id = 0")
    suspend fun updateCounter(newCount: Int)
}

内容的提问来源于stack exchange，提问作者Benedikt Schlüter