Room自动生成代码中@Generated符号无法解析问题求助

问题场景 #

启动应用后，kapt自动生成的UserDao_impl和AppDatabase_impl文件出现Cannot resolve symbol 'Generated'错误，当前不影响数据插入、查询等核心功能，但存在潜在的后续风险。已确认Room 2.2.4官方文档标注修复了JDK9环境下的@Generated使用bug，但使用Gradle JDK 17时仍复现该问题。

排查与解决步骤 #

1. 统一Room依赖版本 #

确保Room的runtime、compiler、ktx（如果使用）依赖版本完全一致，版本不匹配可能导致生成代码逻辑异常：

// build.gradle 或 build.gradle.kts
implementation "androidx.room:room-runtime:2.2.4"
kapt "androidx.room:room-compiler:2.2.4"
implementation "androidx.room:room-ktx:2.2.4" // 若使用Kotlin扩展需添加

2. 配置JDK兼容性与访问权限 #

在模块的构建配置中指定源码/目标兼容版本，并添加JVM参数解决高版本JDK的模块访问限制：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    // 给kapt添加JVM参数，解除对java.lang模块的访问限制
    kapt {
        javacOptions {
            option("--add-opens", "java.base/java.lang=ALL-UNNAMED")
        }
    }
}

3. 清理重构项目 #

旧的生成文件可能残留缓存，导致错误持续存在：

• 执行File -> Invalidate Caches...并重启IDE
• 运行Gradle命令彻底清理构建：

  # macOS/Linux
  ./gradlew clean build
  
  # Windows
  gradlew.bat clean build
  

4. 升级Room版本（推荐） #

Room 2.2.4属于较旧版本，对JDK17的适配支持有限。建议升级到2.5.0及以上的稳定版本，新版本针对高版本JDK做了更完善的兼容处理，能从根源解决这类符号解析问题。升级后需保证所有Room依赖版本统一。

5. 验证IDE的JDK配置 #

确认IDE的JDK配置与项目编译配置一致：

• 打开File -> Project Structure -> SDK Location，检查Gradle JDK是否为17
• 进入Modules -> 对应模块 -> Sources标签，确认Language level与compileOptions中设置的版本匹配（建议设为8）

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