Flutter android debug 编译报错问题。插件编译报错

下面相关内容都以 Mac 电脑为例子。

一、问题

起因：（更新 Android studio 2024.2.2.13、 Flutter SDK 3.27.2）

最近 2025年 1 月左右，我更新了 Android studio 和 Flutter SDK 再运行就会出现下面的问题。
当然下面的提示只是其中之一，即便把所有插件都更新了仍然不行，解决一个还会有第二个插件提示错误 flutter_localizations、firebase_messaging 等等一个接一个全出现编译错误。

FAILURE: Build failed with an exception.

* What went wrong:

Execution failed for task ':shared_preferences_android:compileDebugJavaWithJavac'.

> Could not resolve all files for configuration ':shared_preferences_android:androidJdkImage'.

> Failed to transform core-for-system-modules.jar to match attributes {artifactType=_internal_android_jdk_image, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.

> Execution failed for JdkImageTransform: C:\Users\sdvs1\AppData\Local\Android\sdk\platforms\android-34\core-for-system-modules.jar.

> Error while executing process C:\Program Files\Android\Android Studio_2024_2_1_9\jbr\bin\jlink.exe with arguments {--module-path C:\Users\sdvs1\.gradle\caches\transforms-3\4a46fc89ed5f9adfe3afebf74eb8bfeb\transformed\output\temp\jmod --add-modules java.base --output C:\Users\sdvs1\.gradle\caches\transforms-3\4a46fc89ed5f9adfe3afebf74eb8bfeb\transformed\output\jdkImage --disable-plugin system-modules}

* Try:

> Run with --stacktrace option to get the stack trace.

> Run with --info or --debug option to get more log output.

> Run with --scan to get full insights.

> Get more help at https://help.gradle.org.

二、尝试查找原因

恢复老版本

并没有想太多一定是更新所致，所以尝试恢复了之前的版本，（Android studio giraffe、 Flutter SDK 3.22） 果然都正常工作了。

再次升级最新版本：（Android studio 2024.2.2.13、 Flutter SDK 3.27.2）

目的：新项目不再想用老版本，想都统一升级一下技术栈**（再次升级最新版）**
用新的 Flutter SDK 重新创建版本 ，安装项目依赖（所有依赖更新到最新版本）仍然出现错误。（空白项目可以启动，安装项目依赖例如：shared_preferences 就开始报错）

查到 Flutter GitHub 有相关 issues： (不止个例大部分人都出现了相关问题)

issues 地址 Android plugins: `Failed to transform core-for-system-modules.jar to match attributes` errors with JDK 21 · Issue #156304 · flutter/flutter · GitHub
问题似乎出在 Android studio 身上。（最新版本 android studio 自带了 JDK 21）

手动修改 jdk 版本**（JDK 17）**

修改 JDK 文件路径： android/app/build.gradle
1.

       compileOptions {
         sourceCompatibility JavaVersion.VERSION_17
         targetCompatibility JavaVersion.VERSION_17
       }

       kotlinOptions {
           jvmTarget = JavaVersion.VERSION_17
       }

修改构建工具包 gradle 文件路径：android/gradle/wrapper/gradle-wrapper.properties
1.
```
   distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
```

修改 android/settings.gradle
1.

       id "com.android.application" version "8.3.1" apply false

开始正常运行

未知原因：心力憔悴

但是由于我不小心打开了其他 android 项目导致下载了其他的 gradle。不知道是不是这个原因， 又开始报错了～

三、一劳永逸（解决）

准备降级Android stuido 最近可用的版本。（这个 JDK 21 目前来讲感觉很坑，或许是我没搞明白吧）

经过多个版本尝试（最终下载 Android Studio Koala Feature Drop | 2024.1.2）
1. Android Studio 历史版本下载地址：（只有英文版页面才能看到列表）Android Studio 下载文件归档 | Android Developers
安装前把之前版本 Android studio 删除
删除与资源库同级的 AndroidStudioProjects 文件夹
删除资源库内的 Android , 如果有 java 文件夹一并删除。

为防止出现意外情况，请务必按照上面说的卸载干净。

安装（Android Studio Koala Feature Drop | 2024.1.2）

检查 Flutter Android 是否使用了 jdk17

执行下面命令即可出现上图的检查内容。java sdk 会默认指向 17 的版本

flutter doctor -v

当然如果 Flutter SDK 版本内容之间差距有些大，我的建议最好用当前的 Flutter SDK 重新初始化一个项目，把老项目迁移过来即可，个人感觉成本要比老项目改低的多。

（如果按照这个解决方式、初始化新的项目就不必按照上面去修改build.gradle、gradle-wrapper.properties、settings.gradle 等..配置文件了）