Flutter 3.0.5打包APK报错：':app:compileFlutterBuildRelease'任务执行失败

针对你遇到的compileFlutterBuildRelease任务失败、退出值1的错误，可按以下步骤排查解决：

1. 获取详细错误日志 #

当前日志仅提示任务失败，无具体原因。执行以下命令获取完整报错信息：

flutter build apk --verbose

或

flutter build apk --stacktrace

根据日志里的具体报错（比如空安全违规、资源缺失、依赖冲突等）针对性处理。

2. 排查空安全相关问题 #

日志显示💪 Building with sound null safety 💪，可能存在未遵循空安全规则的代码或依赖：

• 检查所有第三方依赖是否支持空安全，执行flutter pub outdated查看依赖版本，将不支持的依赖更新到最新兼容版本
• 临时尝试关闭空安全构建（仅用于排查，不建议长期使用）：

  flutter build apk --no-sound-null-safety
  

3. 清理缓存后重新构建 #

缓存损坏是常见原因，执行以下操作：

• 清理Flutter缓存：

  flutter clean
  

• 删除项目下的build目录（根目录和android/子目录下的都要删）
• 删除android/.gradle目录
• 重新拉取依赖：

  flutter pub get
  

• 再次尝试构建：

  flutter build apk
  

4. 检查Flutter与Gradle配置兼容性 #

• 确认android/build.gradle中的Gradle版本与Flutter 3.0.5兼容（推荐使用Gradle 7.0及以上版本）
• 检查android/app/build.gradle中的compileSdkVersion和targetSdkVersion，Flutter 3.0.5建议设置为31或更高
• 验证Flutter SDK路径权限：确保/Users/edgar/Documents/tools/flutter-35/目录有读写权限，避免因权限不足导致构建失败

5. 排查依赖冲突 #

• 执行flutter pub deps查看依赖树，检查是否存在版本冲突的依赖，尤其是Android原生依赖
• 临时移除最近添加的依赖，重新构建，排查是否是新依赖导致的问题

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