Flutter版本更新后Android端无法运行的问题求助
解决Flutter 3.29更新后Android构建失败问题
核心问题分析
当前构建失败的关键原因有两点:
- Flutter 3.29要求Android Gradle Plugin(AGP)版本至少为7.3.1,你项目中使用的7.2.2已不在官方支持范围内
- AGP 7.2.2与配置的Gradle 8.9版本不兼容,同时Java 21的特性和旧版AGP存在适配冲突
分步修复方案
1. 升级AGP到兼容Gradle 8.9的版本
打开android/build.gradle文件,找到buildscript下的dependencies块,将AGP版本修改为8.3.2(该版本与Gradle 8.9完全兼容):
classpath 'com.android.tools.build:gradle:8.3.2'
2. 同步Kotlin版本
AGP 8.x需要匹配的Kotlin版本支持,打开android/app/build.gradle,将Kotlin依赖升级到1.9.22:
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.22"
3. 清理缓存并重新构建
执行以下命令清理Flutter和Gradle的旧缓存,避免残留配置干扰:
flutter clean cd android ./gradlew clean cd .. flutter run
临时应急方案(不推荐长期使用)
如果暂时无法升级AGP,可以添加参数跳过依赖校验,但这只是临时手段,后续仍需完成版本升级:
flutter run --android-skip-build-dependency-validation
额外提示
- Java 21对旧版AGP兼容性较差,升级AGP到8.x版本后才能完美适配Java 21
- 升级完成后,检查
android/settings.gradle文件,确保没有遗留的旧版AGP插件引用
内容的提问来源于stack exchange,提问作者Milos N.
相关产品推荐
相关产品推荐

