Flutter默认应用构建失败:Gradle Task退出码1,评估Android项目时出现异常
解决Flutter默认应用构建失败(Gradle退出码1、Android项目评估错误)
这种问题我太熟了!刚接触Flutter的时候踩过好多次这个坑,核心就是Gradle在处理Android项目评估时出了问题,导致构建直接崩了。给你几个按优先级来的解决办法,亲测有效:
先清一波缓存,从头来过
这是最常用的急救手段,先把Flutter和Gradle的缓存都清干净:- 执行Flutter缓存清理:
flutter clean - 进入Android目录下的Gradle文件夹,手动删掉
.gradle文件夹(Windows路径为android\.gradle,Mac/Linux为android/.gradle) - 回到项目根目录,执行
flutter pub get重新拉取依赖 - 再尝试构建:
flutter run
- 执行Flutter缓存清理:
检查Gradle版本和配置兼容性
版本不兼容是这类问题的重灾区:- 打开
android/build.gradle文件,查看dependencies块中的Gradle插件版本,示例如下:
建议选择Flutter官方文档推荐的稳定版本,避免太新或太旧的版本dependencies { classpath 'com.android.tools.build:gradle:7.4.2' // 其他依赖... } - 打开
android/gradle/wrapper/gradle-wrapper.properties,确认distributionUrl指向的Gradle版本与插件版本匹配(比如Gradle 7.5对应插件7.4.x系列):distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
- 打开
确认Android SDK与NDK组件完整性
项目评估失败常因SDK组件缺失:- 打开Android Studio的SDK Manager,检查是否安装了项目
build.gradle中指定的targetSDK对应的SDK Platform(比如targetSDK为33则安装Android 13 SDK) - 检查NDK(Side by side)是否已安装,部分Flutter插件依赖NDK才能正常构建
- 确保
local.properties文件中的SDK路径配置正确,示例:sdk.dir=/Users/你的用户名/Library/Android/sdk ndk.dir=/Users/你的用户名/Library/Android/sdk/ndk/25.1.8937393
- 打开Android Studio的SDK Manager,检查是否安装了项目
修复Debug签名配置
偶尔是签名配置损坏导致评估失败:
打开android/app/build.gradle,检查signingConfigs中的debug配置,恢复为默认即可(丢失的debug.keystore会自动生成):signingConfigs { debug { storeFile file('debug.keystore') storePassword 'android' keyAlias 'androiddebugkey' keyPassword 'android' } }升级Flutter到稳定版
旧版Flutter可能与新版Gradle/Android SDK存在兼容性问题,执行以下命令升级:flutter upgrade
如果以上方法都无法解决,建议把flutter run输出的完整错误日志贴出来——红框里的具体错误信息(比如依赖冲突、组件缺失提示)才是定位问题的关键。
内容的提问来源于stack exchange,提问作者Waleedh Nihal Ahmed
相关产品推荐
相关产品推荐

