Flutter安卓应用编译失败求助：执行compileFlutterBuildDebug任务出错

问题详情 #

之前正常运行的Flutter安卓应用，现在启动时出现如下编译错误：

FAILURE: Build failed with an exception.

• Where:
  Script '/home/anees/snap/flutter/common/flutter/packages/flutter_tools/gradle/flutter.gradle' line: 1159

• What went wrong:
  Execution failed for task ':app:compileFlutterBuildDebug'.

Process 'command '/home/anees/snap/flutter/common/flutter/bin/flutter'' finished with non-zero exit value 1

• Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.

BUILD FAILED in 1m 35s
Exception: Gradle task assembleDebug failed with exit code 1
Exited (sigterm)

已尝试flutter clean、重新添加所有依赖、重启Visual Studio Code，均无效。

可行解决步骤 #

• 查看详细错误栈：在终端执行flutter run --stacktrace，获取更具体的错误信息，定位到底是依赖冲突、资源问题还是版本兼容问题
• 检查Flutter环境：执行flutter doctor，确认环境配置无异常，若有版本不兼容提示，尝试升级或回退Flutter版本（比如flutter downgrade <具体版本号>）
• 清理Gradle缓存：删除项目根目录下的.gradle文件夹，以及android/.gradle文件夹，之后重新执行flutter run
• 对齐安卓SDK版本：确认本地安卓SDK版本与项目build.gradle中指定的compileSdkVersion、targetSdkVersion一致，不一致则调整匹配
• 排查依赖兼容性：逐个排查最近新增或更新的依赖包，暂时注释可疑依赖后重新编译，定位是否是某个依赖导致的冲突
• 重新生成安卓项目文件：执行flutter create --platforms android .（注意末尾的点，操作前备份好原有安卓配置文件）

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