Room报错Cannot find symbol: androidx.room.util.RelationUtil求助

问题背景 #

使用Room定义ItemEntity和CategoryEntity并通过外键关联，创建ItemAndCategoryEntity用@Relation实现一对一查询时，构建项目出现找不到符号androidx.room.util.RelationUtil错误，自动生成的DAO实现类异常，移除关联数据类后构建恢复正常。

解决方案 #

1. 补充完整Room依赖 #

当前依赖缺少room-common组件，Room的关联处理工具类（包括RelationUtil）包含在该组件中。修改app模块的build.gradle，添加room-common依赖，确保所有Room组件版本一致：

// Kotlin Room database
def room_version = "2.5.1"
implementation "androidx.room:room-runtime:$room_version"
implementation "androidx.room:room-ktx:$room_version"
implementation "androidx.room:room-common:$room_version" // 新增依赖
kapt "androidx.room:room-compiler:$room_version"

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

缓存损坏可能导致编译生成的代码异常，执行以下操作：

• 点击Android Studio顶部菜单栏 Build → Clean Project
• 接着执行 Build → Rebuild Project
• 或通过终端运行：./gradlew clean build

3. 验证Kotlin与Room版本兼容性 #

Room 2.5.1要求Kotlin版本≥1.8.0，若Kotlin版本过低会引发编译问题。检查项目根目录build.gradle中的Kotlin插件版本：

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.8.20' apply false // 确保版本不低于1.8.0
}

4. 确认关联配置正确性 #

虽然当前报错不是配置问题，但确保ItemAndCategoryEntity的@Relation配置无误：

data class ItemAndCategoryEntity (
    @Embedded val itemEntity: ItemEntity,
    @Relation(
        parentColumn = "categoryId", // ItemEntity的外键字段
        entityColumn = "id" // CategoryEntity的主键字段
    )
    val categoryEntity: CategoryEntity
)

注意：若存在ItemEntity的categoryId未对应任何CategoryEntity记录的情况，Room会抛出异常，可考虑将categoryEntity改为CategoryEntity?并配合@Relation的optional = true参数。

若仍未解决 #

尝试升级Room到最新稳定版本（如2.6.1），同时保持所有Room组件版本统一，新版本通常修复了旧版本的编译问题。

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