You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter升级Gradle至8.x后Android构建失败问题排查与修复

avatar
云上老周
2026-6-25
问题：Flutter项目Gradle升级至8.5后Android构建失败（D8转换NPE）

问题描述

将Flutter项目Gradle从7.x版本升级至8.5后，执行flutter run时仅Android端构建失败，报错显示:app:mergeLibDexDebug任务执行失败，无法解析:app:debugRuntimeClasspath配置文件，firebase_auth、firebase_core等多个依赖库的classes.jar在D8 dex转换过程中抛出java.lang.NullPointerException，iOS端可正常运行。

错误日志 

ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/firebase_auth/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/firebase_core/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/flutter_local_notifications/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/url_launcher_android/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/path_provider_android/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/google_sign_in_android/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null
ERROR:/Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/connectivity_plus/intermediates/runtime_library_classes_jar/debug/classes.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:mergeLibDexDebug'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform classes.jar (project :firebase_auth) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/firebase_auth/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :firebase_core) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/firebase_core/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :flutter_local_notifications) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/flutter_local_notifications/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :url_launcher_android) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/url_launcher_android/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :path_provider_android) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/path_provider_android/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :google_sign_in_android) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/google_sign_in_android/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.
   > Failed to transform classes.jar (project :connectivity_plus) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, com.android.build.api.attributes.AgpVersionAttr=7.3.0, com.android.build.api.attributes.BuildTypeAttr=debug, com.android.build.gradle.internal.attributes.VariantAttr=debug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: /Users/mohamedrifay/Desktop/Projects/fitish-flutter/build/connectivity_plus/intermediates/runtime_library_classes_jar/debug/classes.jar.
         > Error while dexing.

* 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.

相关配置

app/build.gradle 

plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
}

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

android {
    namespace "com.example.fitish_app"
    compileSdk 34
    ndkVersion flutter.ndkVersion

    //for notification
    defaultConfig {
        multiDexEnabled true
    }

    lintOptions {
            checkReleaseBuilds false
        }

    compileOptions {

         //for notification
        coreLibraryDesugaringEnabled true

        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId "com.example.fitish_app"
        multiDexEnabled true
        // You can update the following values to match your application needs.
        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
        minSdkVersion 21
        targetSdkVersion 30
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        release {
            // TODO: Add your own signing config for the release build.
            // Signing with the debug keys for now, so `flutter run --release` works.
            signingConfig signingConfigs.debug
        }
    }
}

flutter {
    source '../..'
}

dependencies {

    implementation 'com.android.support:multidex:2.0.1'
    //for notification
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.2.2'

}

gradle.properties 

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip

原因分析

  1. AGP与Gradle版本不兼容：Gradle 8.5要求Android Gradle Plugin（AGP）版本至少为8.0+，但日志显示当前使用AGP 7.3.0，版本不匹配导致D8转换逻辑出错。
  2. Desugar库版本过时：使用的desugar_jdk_libs:1.2.2版本过旧，无法适配新Gradle/AGP的字符串处理逻辑，引发空指针异常。
  3. 重复配置冲突：android块中重复定义了defaultConfig，导致构建逻辑混乱。
  4. Flutter插件版本未适配：firebase_auth、flutter_local_notifications等插件版本未兼容新的Gradle/AGP环境。

修复方案

1. 升级Android Gradle Plugin（AGP）版本

在项目根目录的build.gradle中，更新AGP及Kotlin插件版本至与Gradle 8.5匹配的版本：

buildscript {
    dependencies {
        classpath "com.android.tools.build:gradle:8.3.0"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20"
    }
}

2. 更新Desugar库版本

将desugar_jdk_libs升级到最新兼容版本：

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
}

3. 清理重复配置

删除android块中重复的defaultConfig，保留一个完整配置：

android {
    // ... 其他配置
    defaultConfig {
        applicationId "com.example.fitish_app"
        multiDexEnabled true
        minSdkVersion 21
        targetSdkVersion 34 // 建议与compileSdk保持一致
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }
    // ... 其他配置
}

4. 更新Flutter依赖插件版本

在pubspec.yaml中更新所有Android相关插件至最新稳定版本，示例：

dependencies:
  firebase_core: ^2.24.2
  firebase_auth: ^4.16.0
  flutter_local_notifications: ^16.1.0
  url_launcher_android: ^6.2.0
  path_provider_android: ^2.2.0
  google_sign_in_android: ^6.2.1
  connectivity_plus: ^5.0.2

执行flutter pub upgrade完成依赖更新。

5. 清理构建缓存

执行以下命令清理旧缓存，避免干扰：

flutter clean
rm -rf android/.gradle
rm -rf build
flutter pub get

6. 调整Java版本（可选）

若仍有问题，将Java版本升级至11（Gradle 8.x推荐版本）：

compileOptions {
    coreLibraryDesugaringEnabled true
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
}
kotlinOptions {
    jvmTarget = '11'
}

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分)， 限时 9.9 元起

产品介绍相关文档
相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分)， 限时 9.9 元起

产品介绍相关文档
火山引擎 最新活动
全面开放
Doubao-Seedance-2.5全新模型升级

模型再升级,30秒超长叙事, 模态参考扩容

HOT
方舟Codingplan

模型自由，工具不限，最新支持 Deepseek-V4 系列、GLM-5.3 系列

HOT
方舟Agent plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列

HOT
新用户特惠专场

大模型19元起，Al应用9.9元畅享，新人首购爆款尽享优惠

最近更新时间：2026.06.25 10:20:08