构建APK时遭遇Kotlin Gradle插件版本兼容问题求助
问题原因及解决办法
问题原因
- Kotlin Gradle插件与AGP版本不兼容:当前使用的Android Gradle Plugin(AGP)7.3.0与Kotlin Gradle插件1.9.10存在适配冲突,AGP 7.3.0对高版本Kotlin插件的支持不完善。
- 依赖元数据版本不匹配:项目中部分依赖(如Flutter第三方插件)是用Kotlin 1.8编译生成的,而当前Kotlin插件版本过高,导致元数据版本冲突(系统期望1.6.0,实际依赖为1.8.0)。
解决步骤
方案一:对齐Kotlin插件与AGP兼容版本
AGP 7.3.0稳定兼容的Kotlin Gradle插件版本为1.8.20,修改项目根目录build.gradle:
buildscript { ext.kotlin_version = '1.8.20' repositories { google() mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:7.3.0' classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" } }
方案二:清理缓存并重建
执行以下命令彻底清除旧构建缓存,避免残留冲突:
flutter clean flutter build apk
方案三:检查插件兼容性
若上述方案无效,排查项目依赖的Flutter插件:
- 打开
pubspec.yaml,逐一确认第三方插件是否要求特定Kotlin版本 - 升级插件到最新版本,或暂时将Kotlin插件降级至1.6.21(AGP 7.3.0兼容此版本)
备选方案:升级AGP(需同步升级Gradle和Flutter)
若坚持使用Kotlin 1.9.10,需升级AGP至8.0+版本,同时同步升级Gradle到8.0+、Flutter到3.10.0+:
- 修改根目录
build.gradle中AGP版本为8.0.2 - 修改
gradle/wrapper/gradle-wrapper.properties的Gradle版本为8.0 - 执行
flutter upgrade升级Flutter到最新稳定版 - 重新执行清理和构建命令
内容的提问来源于stack exchange,提问作者Thanos Rom
相关产品推荐
相关产品推荐

