新建Jetpack Compose项目出现Unresolved reference报错如何解决

故障根因 #

• Kotlin编译器版本与Jetpack Compose编译器扩展版本不匹配，这是Compose项目最常见的配置冲突问题
• 配置中存在已废弃的冗余配置项，引发编译异常

修复操作步骤 #

1. 校验版本匹配关系
   你当前配置指定的Kotlin编译器版本为1.5.21，对应的Compose编译器扩展版本必须为1.0.5，请先打开项目根目录的gradle.properties文件，查看compose_version的取值：

若compose_version取值高于1.0.5，请直接修改为compose_version=1.0.5；如需使用更高版本Compose，请同步升级Kotlin版本到对应适配版本。

2. 删除冗余配置
   打开模块级build.gradle文件，删除两个冗余配置项：

• 删除kotlinOptions代码块中的useIR = true，新版Kotlin已默认开启IR编译器，重复声明会引发冲突
• 删除composeOptions代码块中的kotlinCompilerVersion '1.5.21'，该配置已废弃，无需单独声明
  调整后的对应代码段如下：

kotlinOptions {
    jvmTarget = '1.8'
}
composeOptions {
    kotlinCompilerExtensionVersion compose_version
}

3. 清理缓存重建项目
   点击Android Studio顶部菜单栏 File → Invalidate Caches，勾选Clear file system cache and local history后点击Invalidate and Restart，等待Android Studio重启后项目自动同步完成即可解决问题。

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