Flutter从Firebase获取地址时遇Gradle assembleDebug执行失败退出码1问题

• 触发场景：尝试从Firebase中检索地址功能时，执行应用Debug构建触发异常
• 表层报错内容：
  • 异常位置：D:\src\flutter\packages\flutter_tools\gradle\flutter.gradle 第904行
  • 直接失败任务：:app:compileFlutterBuildDebug
  • 进程错误提示：执行D:\src\flutter\bin\flutter.bat的进程以非零退出值1结束
  • 构建终止提示：构建流程运行11秒后失败，最终触发Gradle任务assembleDebug执行失败，退出码为1
  • 通用排查提示：搭配--stacktrace参数运行可获取堆栈跟踪；搭配--info或--debug参数运行可获取更详细日志；搭配--scan参数运行可获取完整构建洞察

• 优先获取真实错误栈：不要被表层的Gradle报错误导，:app:compileFlutterBuildDebug的本质是调用Flutter命令完成Dart侧代码编译，绝大多数情况下失败原因不是Gradle本身。直接在项目根目录执行flutter build apk --debug --stacktrace，拿到完整的Dart编译错误信息，是后续所有排查的前提
• 结合Firebase接入场景做高频问题校验：
  • 检查android/app路径下的google-services.json配置：确认文件存放路径正确，文件内的应用包名和项目配置的applicationId完全一致，避免错放其他项目的配置文件导致Firebase初始化校验失败，这类错误经常会被Gradle封装成统一的无明确指向的构建报错
  • 核对依赖版本兼容性：检查当前Flutter SDK版本、所有Firebase相关插件的版本、Gradle版本、Android Gradle Plugin版本是否满足对应插件的最低版本要求，版本不匹配是Firebase接入场景下编译失败的最高发原因
• 本地缓存问题排查：如果以上校验均无问题，依次执行flutter clean、flutter pub get，重新触发Gradle同步后再重试构建。本地Flutter构建缓存、Gradle依赖缓存损坏时，也会触发这类无明确错误栈的构建失败

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