Flutter升级至3.24.3后项目无法构建，引入google_maps_flutter报错

DevOps 小满

2026-6-15

Flutter 3.24.3引入google_maps_flutter后构建失败的解决办法

问题分析

这个报错是因为引入google_maps_flutter:^2.10.0后，Android端执行JDK镜像转换（JdkImageTransform）时出错，大概率和Gradle缓存损坏、JDK版本不兼容，或者依赖版本不匹配有关——毕竟Flutter 3.24.x对Android构建环境的要求有更新。

具体解决方案

1. 先清Gradle缓存试试

直接删掉本地Gradle缓存目录，强制重新生成依赖缓存：

路径：C:\Users\myUser\.gradle\caches
删除整个caches文件夹后，重新执行flutter run或flutter build apk

2. 确认JDK版本用对了

Flutter 3.24.x建议用JDK 17，也就是Android Studio自带的JBR，别混用其他版本：

打开Android Studio，进入File > Project Structure > SDK Location
把JDK location改成Android Studio自带的路径，比如C:\Program Files\Android\Android Studio\jbr
嫌麻烦的话，直接在项目的android/gradle.properties里加一行：
```
org.gradle.java.home=C:\\Program Files\\Android\\Android Studio\\jbr
```

3. 升级google_maps_flutter到新版

2.10.0版本可能和Flutter 3.24.3存在兼容性问题，换成最新稳定版试试：

修改pubspec.yaml里的依赖：

google_maps_flutter: ^2.15.0 # 或者更高的稳定版

执行flutter pub get更新依赖

4. 调整Android Gradle插件版本

确保插件版本和Flutter 3.24.3匹配：

打开android/build.gradle，修改classpath：

dependencies {
    classpath 'com.android.tools.build:gradle:8.3.2' # Flutter 3.24.x推荐的版本
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20"
}

同步修改gradle wrapper版本，打开gradle/wrapper/gradle-wrapper.properties：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip
```