Flutter中Gradle task assembleDebug失败（退出码1）求助

1. 排查build.gradle的Groovy语法问题 #

• 打开项目根目录及安卓模块下的build.gradle文件，重点检查：
  • 字符串引号、代码括号是否完全配对，避免漏写闭合符号
  • 依赖声明格式是否合规，比如implementation 'groupId:artifactId:version'的符号、拼写是否正确
  • 自定义Groovy脚本（若有）中的变量引用、方法调用是否合法
• 常见坑点：把赋值符号=误写为判断符号==，或依赖版本号格式错误

2. 清理缓存并重新同步项目 #

• 执行命令清理缓存：

  flutter clean
  rm -rf ~/.gradle/caches/  # Linux/Mac环境
  # Windows环境直接删除C:\Users\<你的用户名>\.gradle\caches目录
  

• 回到Android Studio，点击「File > Sync Project with Gradle Files」重新同步

3. 检查pubspec.yaml的依赖冲突 #

• 执行flutter pub deps查看完整依赖树，排查是否有Flutter插件依赖了与当前Gradle版本不兼容的安卓库
• 针对冲突依赖，尝试升级或降级对应插件版本

4. 验证Android SDK配置 #

• 打开Android Studio的「SDK Manager」，确认已安装与build.gradle中指定版本一致的Android SDK Build-Tools
• 检查local.properties文件中的sdk.dir路径是否正确，无拼写错误

5. 匹配Gradle wrapper与插件版本 #

• 打开gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为兼容版本，示例：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip
  

• 确保该Gradle版本与build.gradle中com.android.tools.build:gradle的版本匹配（如gradle-8.5对应gradle插件8.2.0）

6. 获取详细错误日志定位问题 #

• 执行flutter run -v，查看完整的错误输出，找到Groovy错误的具体行号和描述，直接定位修改

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