Flutter运行报错Gradle task assembleDebug failed with exit code 1是什么原因？

核心报错原因 #

你遇到的Gradle task assembleDebug failed with exit code 1属于Flutter Android构建通用失败报错，当前日志仅能判定是compileFlutterBuildDebug任务执行异常，没有输出具体根因，结合你的操作历史，常见触发原因如下：

• 你使用的Flutter 2.3是较老的测试版本，和项目中配置的Android Gradle插件版本不兼容
• Flutter构建缓存、项目依赖缓存存在脏数据，单纯执行flutter pub upgrade无法清理异常缓存
• Android构建过程中拉取依赖资源失败，未配置国内镜像的情况下默认请求的海外仓库经常出现连接超时问题
• 项目中存在Dart语法错误，编译阶段触发异常退出

修复方案 #

• 先执行全量缓存清理：
  依次运行命令flutter clean、删除项目根目录下的build文件夹、删除android/.gradle缓存文件夹，之后重新执行flutter pub get再尝试启动项目
• 校验Gradle版本匹配关系：
  打开项目android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl对应的Gradle版本在6.7~7.0区间，这是Flutter 2.3的兼容范围；同时打开android/build.gradle，确认com.android.tools.build:gradle的版本和Gradle版本匹配，例如Gradle 6.7对应AGP版本为4.1.x
• 配置国内镜像源：
  打开android/build.gradle，将buildscript和allprojects代码块下的maven仓库替换为阿里云镜像：

  maven { url 'https://maven.aliyun.com/repository/google' }
  maven { url 'https://maven.aliyun.com/repository/jcenter' }
  

• 查看完整错误日志：
  以上操作都无效的话，在项目根目录执行flutter run -v启动构建，输出的全量日志会标注具体的编译错误点，可以精准定位问题

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