Flutter集成Firebase时google-services.json文件找不到问题排查

问题重现 #

构建过程中持续抛出以下错误：

Execution failed for task ':processDebugGoogleServices'.
 File google-services.json is missing.
  The Google Services Plugin cannot function without it.
  Searched locations:
  C:\Users\Ryan\Documents\Child1st\Android 2.0\android2\android\src\debug\google-services.json
  C:\Users\Ryan\Documents\Child1st\Android 2.0\android2\android\src\google-services.json
  C:\Users\Ryan\Documents\Child1st\Android 2.0\android2\android\google-services.json

但google-services.json实际存在于路径：C:\Users\Ryan\Documents\Child1st\Android 2.0\android2\android\app\google-services.json，且已完成包名验证、Gradle依赖检查、项目重建、Android Studio同步等排查步骤，问题仍未解决。

可能的原因及解决步骤 #

1. 优先处理路径空格问题 #

项目路径包含Android 2.0空格字符，Gradle在解析带空格的Windows路径时易出现异常，这是高频触发该问题的原因。

• 重命名路径为无空格格式（如Android2.0或Android_2.0）
• 依次执行：

  flutter clean
  cd android && ./gradlew.bat clean
  cd .. && flutter pub get
  flutter run
  

2. 检查Google Services插件的应用逻辑 #

• 项目级build.gradle.kts（android目录下，非app子目录）需正确引入插件依赖：

  plugins {
      id("com.android.application") version "7.4.2" apply false
      id("com.google.gms.google-services") version "4.4.0" apply false
      id("kotlin-android") version "1.8.22" apply false
  }
  

• **app模块build.gradle.kts**需调整插件应用顺序，确保Flutter插件优先于Google Services插件：

  plugins {
      id("com.android.application")
      id("kotlin-android")
      id("dev.flutter.flutter-gradle-plugin")
      id("com.google.gms.google-services")
  }
  

3. 验证项目模块结构 #

错误日志显示Gradle在android/根目录下查找文件，说明可能模块配置异常：

• 打开android/settings.gradle.kts，确认仅包含:app模块：

  include(":app")
  

• 确保android/app目录是唯一的应用模块，无其他自定义模块干扰Gradle的文件检索逻辑。

4. 手动指定配置文件路径 #

若上述步骤无效，可在app模块build.gradle.kts中强制指定google-services.json路径：

googleServices {
    googleServicesJson = file("google-services.json")
}

将该代码块放在android块之外即可。

5. 检查文件权限与编码 #

• 右键google-services.json → 属性 → 安全，确保当前用户拥有完全控制权限
• 用文本编辑器打开文件，转换为UTF-8 无BOM格式后保存，避免编码问题导致Gradle解析失败

内容的提问来源于stack exchange，提问作者Ryan The Great