Flutter项目集成cloud_firestore Android构建失败求助

这个Dex合并错误是Flutter集成Firebase时很常见的坑，我帮你梳理几个大概率能解决问题的方向：

1. 启用Multidex（最常见原因） #

当项目方法数超过Android Dex文件的65536上限时，就会触发这个错误。按以下步骤配置：

• 打开android/app/build.gradle，在defaultConfig块中添加：

  multiDexEnabled true
  

• 同样在dependencies块中添加Multidex依赖（根据你的Android版本选择）：

  // 非AndroidX项目
  implementation 'com.android.support:multidex:1.0.3'
  // AndroidX项目
  implementation 'androidx.multidex:multidex:2.0.1'
  

• 如果项目有自定义Application类，让它继承MultiDexApplication；如果没有，修改AndroidManifest.xml中的application标签：

  <application
      android:name="android.support.multidex.MultiDexApplication" <!-- AndroidX项目用androidx.multidex.MultiDexApplication -->
      ...>
  

2. 统一Google Play Services和Firebase版本依赖 #

cloud_firestore依赖的Google Play Services组件可能和其他插件的依赖版本冲突，导致Dex合并失败。可以在android/build.gradle的buildscript块中统一指定版本：

buildscript {
    ext {
        googlePlayServicesVersion = "16.0.1"
        firebaseVersion = "17.3.0"
    }
    // ... 其他原有配置
}

这个版本需要和你使用的cloud_firestore版本兼容，你可以对照cloud_firestore的版本说明确认对应值。

3. 清理构建缓存 #

有时候缓存文件损坏也会导致奇怪的构建错误，执行以下命令彻底清理：

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

4. 检查google-services插件版本兼容性 #

你当前使用的com.google.gms:google-services:4.0.1版本可能和cloud_firestore: ^0.8.2+3不兼容，可以尝试升级到更高稳定版本，比如：

classpath 'com.google.gms:google-services:4.3.10'

5. 排查重复依赖 #

用flutter pub deps命令查看项目的依赖树，检查是否有其他Firebase相关插件（比如firebase_auth、firebase_storage）引入了冲突的依赖版本，必要时可以通过dependency_overrides在pubspec.yaml中强制统一版本。

建议先从清理缓存和启用Multidex开始尝试，这两个解决了大部分同类问题。

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