Flutter真机运行报错：JetifyTransform执行失败及Java堆空间不足

问题现象 #

Flutter项目在模拟器运行正常，但真机实时预览时始终报错，错误核心是JetifyTransform执行失败，提示arm64相关文件转换时Java heap space（Java堆内存不足）。新建空白Flutter项目运行，同样出现该错误。

已尝试的无效方案 #

• 修改build.gradle添加lintOptions
• 执行flutter clean和flutter pub get
• 更新build.gradle中的Kotlin版本
• 删除项目内/android/.gradle文件夹
• 删除全局C:/Users/XX/.gradle的缓存文件夹及整个全局.gradle文件夹

报错日志 #

Projects $ flutter create bare_flutter
Creating project bare_flutter...
[...]
Your application code is in bare_flutter\lib\main.dart.

Projects $ cd .\bare_flutter\
bare_flutter $ flutter run
Launching lib\main.dart on Pixel 6 in debug mode...
Picked up _JAVA_OPTIONS: -Xmx512M

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:checkDebugDuplicateClasses'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform arm64_v8a_debug-1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091.jar (io.flutter:arm64_v8a_debug:1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091) to match attributes {artifactType=enumerated-runtime-classes, org.gradle.category=library, org.gradle.libraryelements=jar, org.gradle.status=release, org.gradle.usage=java-runtime}.
      > Execution failed for JetifyTransform: C:\Users\XX\.gradle\caches\modules-2\files-2.1\io.flutter\arm64_v8a_debug\1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091\17f3c0ac3e0e5cdc13df2596bac1d5e83834815d\arm64_v8a_debug-1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091.jar.
         > Java heap space
   > Failed to transform x86_64_debug-1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091.jar (io.flutter:x86_64_debug:1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091) to match attributes {artifactType=enumerated-runtime-classes, org.gradle.category=library, org.gradle.libraryelements=jar, org.gradle.status=release, org.gradle.usage=java-runtime}.
      > Execution failed for JetifyTransform: C:\Users\XX\.gradle\caches\modules-2\files-2.1\io.flutter\x86_64_debug\1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091\77ef080b94d39403b46d649dbecf8178ae61ac1e\x86_64_debug-1.0.0-54a7145303f0dd9d0f93424a2e124eb4abef5091.jar.
         > Java heap space
[...]
BUILD FAILED in 26s
Running Gradle task 'assembleDebug'...                             27.5s
Exception: Gradle task assembleDebug failed with exit code 1

flutter doctor -v 输出 #

bare_flutter $ flutter doctor -v
[✓] Flutter (Channel stable, 3.16.4, on Microsoft Windows [Version 10.0.22621.2861], locale en-IN)
    • Flutter version 3.16.4 on channel stable at D:\dev\Flutter\flutter_windows_3_13_9_stable
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 2e9cb0aa71 (9 days ago), 2023-12-11 14:35:13 -0700
    • Engine revision 54a7145303
    • Dart version 3.2.3
    • DevTools version 2.28.4

[✓] Windows Version (Installed version of Windows is version 10 or higher)

[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    • Android SDK at C:\Users\Dhruv\AppData\Local\Android\sdk
    • Platform android-34-ext8, build-tools 34.0.0
    • Java binary at: D:\Program Files\Android\Android Studio\jbr\bin\java
    • Java version OpenJDK Runtime Environment (build 17.0.6+0-b2043.56-10027231)
    • All Android licenses accepted.

[✓] Chrome - develop for the web
    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[✓] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.7.6)
    • Visual Studio at C:\Program Files\Microsoft Visual Studio\2022\Community
    • Visual Studio Community 2022 version 17.7.34221.43
    • Windows 10 SDK version 10.0.22621.0

[✓] Android Studio (version 2022.3)
    • Android Studio at D:\Program Files\Android\Android Studio
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version openjdk version "17.0.6" 2023-01-17

[✓] VS Code (version 1.85.1)
    • VS Code at C:\Users\Dhruv\AppData\Local\Programs\Microsoft VS Code
    • Flutter extension version 3.78.0

[✓] Connected device (4 available)
    • Pixel 6 (mobile)  • 19121FDF6001DG • android-arm64  • Android 14 (API 34)
    • Windows (desktop) • windows        • windows-x64    • Microsoft Windows [Version 10.0.22621.2861]
    • Chrome (web)      • chrome         • web-javascript • Google Chrome 120.0.6099.110
    • Edge (web)        • edge           • web-javascript • Microsoft Edge 120.0.2210.77

[✓] Network resources
    • All expected network resources are available.

• No issues found!

pubspec.yaml 内容 #

name: bare_flutter
description: "A new Flutter project."

publish_to: "none"

version: 1.0.0+1

environment:
  sdk: ">=3.2.3 <4.0.0"

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true

解决方案 #

从报错信息里的Java heap space可以看出，核心问题是Gradle运行时Java堆内存不足，导致JetifyTransform无法完成转换。可按以下步骤解决：

1. 修改Gradle全局配置
   在全局.gradle文件夹（C:\Users\你的用户名\.gradle）下创建或编辑gradle.properties文件，添加以下配置：

   org.gradle.jvmargs=-Xmx2048M -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
   

   可根据自身设备内存调整堆内存数值（比如-Xmx4096M）。

2. 移除系统环境变量的内存限制
   报错日志显示Picked up _JAVA_OPTIONS: -Xmx512M，说明系统环境变量设置了Java堆内存上限为512M，会覆盖Gradle配置：

   • 打开系统环境变量设置，找到_JAVA_OPTIONS变量
   • 删除该变量，或修改为更大的内存值（比如-Xmx2048M）
   • 重启终端和IDE使配置生效

3. 验证修复
   执行flutter clean，再重新运行flutter run，观察错误是否消失。

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