Android Studio中Room DAO Query注解SQL自动补全校验失效如何解决

对应问题场景：打开Room DAO相关文件后，@Query注解内的SQL字符串无自动补全、无错误检测，故意写错SQL关键字（如将FROM写为FRR）IDE也不会报红提示；普通Kotlin/Java代码补全运行正常，执行Invalidate Caches重启IDE后问题无改善。

按以下优先级排查修复：

• 核对Room依赖版本一致性：room-compiler注解处理器（无论用kapt还是ksp）的版本必须和room-runtime依赖版本完全对齐，跨版本是该问题最高发原因。参考配置：

// 模块级build.gradle.kts 配置示例
dependencies {
    val roomVersion = "2.6.1"
    implementation("androidx.room:room-runtime:$roomVersion")
    // kapt和ksp二选一，版本必须和runtime完全一致
    kapt("androidx.room:room-compiler:$roomVersion")
    // ksp("androidx.room:room-compiler:$roomVersion")
    implementation("androidx.room:room-ktx:$roomVersion")
}

修改完依赖后同步Gradle，等待索引构建完成再测试功能。

• 确认Room插件启用状态：打开Settings > Plugins，搜索Room，确认IDE自带的Room支持插件为勾选启用状态，若被禁用勾选后重启IDE即可。
• 检查语言注入配置：打开Settings > Editor > Language Injections，搜索androidx.room.Query，确认对应的SQLite语言注入规则为启用状态；也可以直接将光标定位到@Query的字符串内，按Alt+Enter选择Inject language or reference，手动指定为SQLite，即可立刻恢复补全校验。
• 核对Room注解配置完整性：确认DAO类添加了@Dao注解，对应数据库类添加了@Database注解，且在entities参数中声明了所有用到的表实体，注解处理器识别不到完整表结构时不会触发SQL校验逻辑。
• 深度清理项目缓存：单纯Invalidate Caches清理不彻底时，关闭IDE，删除项目根目录下的.gradle、.idea文件夹，以及各模块下的build文件夹，重新打开项目等待同步、索引构建完成。
• 排查IDE版本问题：若使用的是Android Studio Canary/Beta预览版，部分预览版本存在Room支持失效的已知bug，切换到官方稳定版即可恢复。

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