Flutter ':app:compileFlutterBuildDebug'报错及自定义图标配置问题

• 先清除旧构建缓存：在项目根目录执行flutter clean，之后执行flutter pub get重新拉取依赖再尝试编译
• 检查Android端版本配置：打开android/build.gradle和android/app/build.gradle文件，确认compileSdk、minSdk、targetSdk的版本，和项目引入的第三方插件要求的版本匹配，版本不兼容是触发该报错的常见原因
• 检查依赖冲突：执行flutter pub deps查看依赖树，排查是否有版本冲突的第三方包，冲突的话统一指定兼容版本即可
• 调整Gradle使用的JDK版本：如果JDK版本和Gradle版本不兼容，在Android Studio设置中将Gradle运行的JDK改为Android Studio自带的JDK即可
• 升级Flutter SDK：如果当前SDK版本过旧和插件版本不匹配，执行flutter upgrade升级到稳定版后重新编译

• 首先确认yaml配置缩进规范：assets配置必须是flutter节点的子节点，缩进严格符合yaml要求，错误和正确示例如下：

错误写法：

# 和flutter节点平级属于配置错误
assets:
  - assets/icons/

正确写法：

flutter:
  uses-material-design: true
  # assets相对flutter节点缩进2个空格，路径相对assets再缩进2个空格
  assets:
    - assets/icons/

• 确认图标文件合规：检查图标文件为png、webp等Flutter支持的格式，文件命名不要使用中文、特殊字符、空格，存放目录也不要包含中文或特殊字符
• 确认代码引用路径正确：代码中引用图标的路径要和pubspec配置的路径完全一致，大小写也要严格匹配，比如配置路径是assets/icons/back.png，代码中就要写AssetImage('assets/icons/back.png')
• 配置修改完成后必须执行flutter pub get使配置生效，重启应用后再查看图标加载状态
• 如果是使用flutter_launcher_icons插件配置应用启动图标，要确认插件配置的图标路径正确，执行flutter pub run flutter_launcher_icons:main生成各端图标后再重新编译应用

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