Android Studio无法引用Room-runtime依赖中的符号问题求助

我在为Android项目添加Room数据持久化功能时，遇到了无法引用room-runtime中类的问题，出现「无法解析符号」的报错。先后切换Room 2.3.4和2.0.0版本尝试解决，均无效果。

当前build.gradle中相关配置如下：

def room_version = "2.0.0"
implementation "androidx.room:room-runtime:$room_version"
annotationProcessor "androidx.room:room-compiler:$room_version"
implementation "androidx.room:room-common:$room_version"

目前的现象是：import androidx.room.Database;能正常导入，项目标签页中room-common的jar包可正常识别，但存放Room和RoomDatabase的room-runtime为aar包，其符号无法解析；外部库中room-runtime已被Gradle下载，但仍无法引用其中的类。

以下是可行的解决步骤：

• 清理并重建项目
  执行Android Studio菜单栏的Build > Clean Project，完成后再执行Build > Rebuild Project，清除旧编译缓存并重新生成依赖关联。

• 优化Gradle依赖配置
  不需要手动添加room-common依赖，因为room-runtime已经默认依赖了它，手动添加可能导致版本冲突。修改后的配置如下（推荐使用较新的稳定版本）：

  def room_version = "2.3.4"
  implementation "androidx.room:room-runtime:$room_version"
  annotationProcessor "androidx.room:room-compiler:$room_version"
  

  若项目使用Kotlin，需将annotationProcessor替换为kapt。

• 确认AndroidX迁移完成
  检查gradle.properties文件，确保包含以下配置，保证项目完全迁移到AndroidX：

  android.useAndroidX=true
  android.enableJetifier=true
  

• 手动清除Gradle本地缓存
  若清理项目无效，手动删除本地Gradle缓存目录：

  • Windows系统：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux系统：~/.gradle/caches
    删除后重启Android Studio，执行File > Sync Project with Gradle Files重新同步项目。

• 检查依赖范围
  确认room-runtime的依赖使用的是implementation而非compileOnly，compileOnly仅在编译阶段生效，运行时不会包含该依赖，会导致类无法找到。

• 验证AAR包完整性
  打开项目的External Libraries，找到room-runtime的AAR包，右键选择「Show in Explorer/Finder」，解压后检查是否包含classes.jar，且jar包内存在Room、RoomDatabase等目标类。若包损坏，删除后重新同步Gradle让其重新下载。

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