Flutter构建报错：配置:google_maps_flutter_android项目失败求助

问题概述 #

无代码/配置改动的情况下，构建Flutter应用触发Gradle配置错误：

A problem occurred configuring project ':google_maps_flutter_android'

已执行flutter clean、flutter pub cache repair操作无效，具体报错细节：

• 无法从缓存加载C:\flutter.pub-cache\hosted\pub.dartlang.org\google_maps_flutter_android-2.4.3\android\build.gradle的编译类
• 项目评估监听器失败：
  • 无法获取项目:google_maps_flutter_android的android属性
  • 找不到参数为project ':flutter_plugin_android_lifecycle'的implementation()方法

解决方案 #

1. 验证Gradle与AGP版本兼容性 #

google_maps_flutter_android:2.4.3要求Android Gradle Plugin(AGP) 7.0+、Gradle 7.0+，按以下步骤检查配置：

• 打开项目根目录android/build.gradle，确认buildscript依赖：

  buildscript {
      ext.kotlin_version = '1.7.10'
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.2.0'
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
      }
  }
  

• 修改android/gradle/wrapper/gradle-wrapper.properties的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip
  

2. 更新或锁定依赖版本 #

在pubspec.yaml中指定google_maps_flutter的稳定版本（建议升级到最新兼容版）：

dependencies:
  google_maps_flutter: ^2.5.0 # 替换为最新稳定版

执行flutter pub get后重新构建。

3. 清理本地Gradle缓存 #

• 删除项目内的android/.gradle目录
• 删除系统级Gradle缓存（Windows路径：C:\Users\<你的用户名>\.gradle\caches）
• 重新执行flutter run，让Gradle重新下载依赖并生成缓存

4. 修复插件的build.gradle文件 #

找到本地缓存的插件目录C:\flutter.pub-cache\hosted\pub.dartlang.org\google_maps_flutter_android-2.4.3\android，打开build.gradle确认开头是否包含以下配置，缺失则手动添加：

apply plugin: 'com.android.library'
apply plugin: 'kotlin-android'

android {
    // 原有配置内容
}

若文件损坏，直接删除该插件目录，执行flutter pub cache repair重新下载。

5. 升级Flutter SDK版本 #

执行flutter --version确认SDK版本，google_maps_flutter_android:2.4.3建议搭配Flutter 3.0+，若版本过旧，执行：

flutter upgrade

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