Kotlin安卓项目Unresolved reference及编译报错问题排查

核心配置问题 #

• Gradle与AGP版本不兼容：你使用的Gradle版本为7.4.2，但顶层build.gradle中声明的Android Gradle插件版本为7.2.0，该版本AGP最高仅支持Gradle 7.3.3。版本不匹配会直接导致依赖解析失败、类索引异常，是编辑器报未解析引用、构建时报类访问错误的核心诱因。
• 依赖版本冲突：你引入的androidx.fragment:fragment-ktx:1.5.0-alpha01属于预览版本，和当前使用的appcompat 1.2.0、navigation 2.3.0依赖的稳定版Fragment组件存在版本冲突，会直接打乱AndroidX相关类的类路径，导致出现setContentView参数不匹配、ConstraintLayout类无法访问的报错。
• 构建缓存/生成类异常：版本不匹配和依赖冲突会导致ViewBinding无法正常生成ActivityMainBinding类，进一步加剧未解析引用的报错。

修复步骤 #

1. 替换AGP版本适配Gradle 7.4.2
   修改顶层build.gradle中的AGP依赖版本为7.4.2，和本地Gradle版本完全匹配：

   buildscript {
       ext.kotlin_version = "1.6.21"
       repositories {
           google()
           mavenCentral()
       }
       dependencies {
           classpath 'com.android.tools.build:gradle:7.4.2'
           classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
       }
   }
   

2. 替换冲突依赖，统一AndroidX版本
   移除预览版Fragment依赖，将所有AndroidX相关依赖升级到兼容compileSdk 32的稳定版本，避免类冲突，修改模块级build.gradle的dependencies块如下：

   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
       implementation 'androidx.core:core-ktx:1.7.0'
       implementation 'androidx.appcompat:appcompat:1.4.2'
       implementation 'com.google.android.material:material:1.6.1'
       implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
       implementation 'androidx.navigation:navigation-fragment-ktx:2.4.2'
       implementation 'androidx.navigation:navigation-ui-ktx:2.4.2'
   }
   

   不需要单独引入fragment-ktx，appcompat和navigation组件已经会传递依赖对应版本的稳定Fragment库。
3. 确认布局文件符合ViewBinding要求
   检查app/src/main/res/layout路径下是否存在activity_main.xml文件，且文件中包含id为toolbar的MaterialToolbar控件，最小可用布局代码参考如下：

   <?xml version="1.0" encoding="utf-8"?>
   <androidx.constraintlayout.widget.ConstraintLayout
       xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
   
       <com.google.android.material.appbar.MaterialToolbar
           android:id="@+id/toolbar"
           android:layout_width="match_parent"
           android:layout_height="?attr/actionBarSize"
           app:layout_constraintTop_toTopOf="parent"
           android:background="?attr/colorPrimary"
           android:titleTextColor="@android:color/white"/>
   
   </androidx.constraintlayout.widget.ConstraintLayout>
   

4. 清理缓存重新构建
   在项目根目录执行以下命令，清除旧构建产物、重新拉取依赖并生成ViewBinding类：

   gradle clean
   gradle assembleDebug
   

   首次构建成功后，VSCode的Kotlin语言服务会自动重新索引所有依赖类和生成的绑定类，编辑器中的未解析引用标记会自动消失。

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