启动新构建的Flutter应用时遭遇Gradle构建失败错误求助

报错信息 #

PS D:\Documents\Flutter Projects\DBG-fe\android> flutter run
Changing current working directory to: D:\Documents\Flutter Projects\DBG-fe
Launching lib\main.dart on M2103K19I in debug mode...
Warning: SDK processing. This version only understands SDK XML versions up to 3 but an SDK XML file of version 4 was encountered. This can happen if you use versions of Android Studio and the command-line tools that were released at different times.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':path_provider_android:compileDebugJavaWithJavac'.
> Could not resolve all files for configuration ':path_provider_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\ALKESH VISHWKARMA\AppData\Local\Android\sdk\platforms\android-34\core-for-system-modules.jar.
         > Error while executing process C:\Program Files\Android\Android Studio\jbr\bin\jlink.exe with arguments {--module-path C:\Users\ALKESH VISHWKARMA\.gradle\caches\transforms-3\8254df3c5c93aab8b63b7456581939e9\transformed\output\temp\jmod --add-modules java.base --output C:\Users\ALKESH VISHWKARMA\.gradle\caches\transforms-3\8254df3c5c93aab8b63b7456581939e9\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.

BUILD FAILED in 1m 43s
Running Gradle task 'assembleDebug'...                            104.9s
Error: Gradle task assembleDebug failed with exit code 1
PS D:\Documents\Flutter Projects\DBG-fe\android> 

问题根源 #

• Android Studio与SDK命令行工具版本不匹配：当前工具仅支持最高版本3的SDK XML配置文件，但检测到android-34的SDK XML版本为4
• 版本不兼容导致path_provider_android插件的Gradle编译任务失败，进而触发JdkImageTransform转换错误

解决步骤 #

1. 统一Android Studio与SDK命令行工具版本 #

• 打开Android Studio，进入Settings → Appearance & Behavior → System Settings → Android SDK → SDK Tools
• 勾选「Android SDK Command-line Tools (latest)」，点击Apply完成更新，确保工具版本与Android Studio一致
• 检查Android SDK Platforms中android-34的组件是否完整，若有损坏则重新安装

2. 清理缓存与重建项目 #

• 删除本地Gradle缓存文件夹：C:\Users\ALKESH VISHWKARMA\.gradle\caches
• 回到Flutter项目根目录，执行以下命令：

  flutter clean
  flutter pub get
  

3. 调整Gradle与SDK配置 #

• 打开项目android/build.gradle文件，确保gradle版本与Android Studio兼容（建议使用7.4及以上版本）
• 若暂时无法更新工具，可将android/app/build.gradle中的compileSdkVersion和targetSdkVersion降级为33

4. 验证JDK配置 #

• 进入Android Studio的Settings → Build, Execution, Deployment → Build Tools → Gradle
• 选择「Embedded JDK」，确保使用Android Studio内置的JetBrains Runtime，避免外部JDK版本冲突

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