添加Firebase类依赖后:app:mergeDexDebug构建失败求助

问题场景 #

在项目的pubspec.yaml中添加Firebase相关依赖后，执行构建时触发:app:mergeDexDebug任务失败，具体错误表现为多个Firebase相关模块（firebase_auth、firebase_storage、cloud_firestore、firebase_core、google_sign_in_android）的classes.jar文件转换dex时出错。已尝试调整Kotlin、Java、Gradle版本，问题仍未解决。

解决方案 #

1. 启用MultiDex支持 #

在android/app/build.gradle中配置MultiDex：

android {
    defaultConfig {
        // 保留原有配置，添加以下行
        multiDexEnabled true
    }
}

dependencies {
    // 添加MultiDex依赖
    implementation 'androidx.multidex:multidex:2.0.1'
}

如果项目使用自定义Application类，需让其继承MultiDexApplication，或在attachBaseContext方法中添加：

@Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(base);
    MultiDex.install(this);
}

2. 彻底清理并重建项目 #

执行以下命令清理缓存并重新构建：

flutter clean
cd android && ./gradlew clean
cd .. && flutter pub get
flutter run

3. 统一Firebase依赖版本 #

确保pubspec.yaml中所有Firebase依赖版本相互兼容，建议使用官方推荐的统一版本：

dependencies:
  firebase_core: ^2.15.0
  firebase_auth: ^4.10.0
  firebase_storage: ^11.2.0
  cloud_firestore: ^4.8.0
  google_sign_in: ^5.4.0

4. 增大Dex编译堆内存 #

在android/app/build.gradle的android块中添加Dex配置，避免内存不足导致转换失败：

android {
    // 保留原有配置，添加以下块
    dexOptions {
        javaMaxHeapSize "4g"
    }
}

5. 确认JDK版本兼容性 #

Android Gradle Plugin 7.x系列推荐使用JDK 11，通过java -version检查当前JDK版本，若不符则切换至JDK 11。

额外排查步骤 #

• 删除android/.gradle和项目根目录下的build文件夹，重新执行构建
• 使用flutter pub deps查看依赖树，排查是否存在重复依赖或冲突依赖

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