如何解决Flutter运行时报错Execution failed for task ':app:compileFlutterBuildDebug'

1. 先获取完整错误日志 #

当前报错是通用的构建失败提示，没有暴露具体根因，首先执行命令获取全量编译日志：
flutter run -v
在输出的日志中找最早出现的标红错误内容，优先定位具体错误点，常见的根因包含Dart语法错误、pubspec资源配置错误、依赖版本冲突三类。

2. 依赖问题排查 #

• 执行flutter pub cache repair修复本地损坏的依赖缓存，之后重新执行flutter pub get拉取依赖
• 如果存在依赖版本冲突，可临时将冲突依赖的版本号改为any，确认可正常编译后再锁定兼容的具体版本
• 若为旧项目迁移到高版本Flutter SDK的场景，检查所有三方依赖是否已适配当前使用的Flutter SDK版本

3. Android构建配置排查 #

• 进入项目android目录，执行./gradlew clean清理Android端构建缓存后再重试编译
• 检查android/build.gradle中的Gradle插件版本、Kotlin版本和当前Flutter SDK兼容：Flutter 3.0+建议使用Gradle插件7.0+、Kotlin 1.7.0+版本
• 核对android/gradle/wrapper/gradle-wrapper.properties中的Gradle版本和Gradle插件版本匹配，比如插件7.4对应Gradle 7.5版本

4. 通用场景排查 #

• 检查项目完整路径是否包含中文、空格、特殊字符，这类字符会导致部分构建脚本执行失败，建议将项目移到纯英文无特殊字符的路径下
• 执行flutter doctor检查本地环境配置，确保所有检测项均为正常通过状态，修复所有标红的环境问题后重试

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