Android Studio构建APK时Kotlin出现Unresolved reference报错如何解决

1. 修复Kotlin与Gradle版本不兼容问题 #

当前使用的Kotlin 1.4.31与Gradle 7.1.1版本不匹配，Gradle 7.x系列要求Kotlin插件版本最低为1.5.0，先做版本对齐：

• 打开项目android/build.gradle文件，修改全局Kotlin版本配置：

buildscript {
    ext {
        kotlinVersion = "1.5.31" // 替换原有1.4.31，该版本与Gradle7.1.1完全兼容
    }
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
    }
}

• 检查环境变量拼写，你提到的GRABLE_PATH为拼写错误，正确应为GRADLE_PATH，确认所有环境变量配置无误。

2. 清理全链路缓存 #

• 关闭Android Studio，删除项目根目录下的node_modules文件夹、yarn.lock/package-lock.json文件
• 进入android目录，删除.gradle、根目录build、app/build三个文件夹
• 重新执行前端依赖安装：npm install 或 yarn install

3. 重新同步Gradle配置 #

• 用Android Studio重新打开项目的android文件夹，等待Gradle自动同步完成，同步过程中提示升级Kotlin插件直接确认即可
• 同步完成后依次点击顶部菜单栏 Build -> Clean Project、Build -> Rebuild Project 重新构建

4. 排查第三方原生插件冲突 #

如果上述操作后仍报错，大概率是你安装的RN原生第三方插件自带的Kotlin版本与项目全局版本不一致：

• 找到报错信息里指向的依赖包，进入其Android目录下的build.gradle文件
• 将其配置的kotlin版本统一修改为和项目全局一致的1.5.31即可

注意事项 #

你提到的Visual Basic应为笔误，React Native开发不涉及Visual Basic，若测试阶段是通过Expo Go运行正常，不要直接修改Expo生成的原生配置文件，所有原生修改优先通过app.json的expo配置项完成，避免配置冲突。

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