Android Studio 3.0出现Unable to merge dex问题求助

嘿，我之前也碰到过一模一样的问题——隔了好几个月重新打开旧项目，突然就爆Dex合并失败的错！结合你的情况，给你几个按优先级排序的解决方案，挨个试试：

1. 先清理重建项目，排除缓存问题 #

这是最基础也最容易见效的一步：

• 打开Android Studio，点击顶部菜单栏的 Build -> Clean Project，等清理完成后再点击 Rebuild Project
• 也可以手动删除项目根目录下的build文件夹，然后重新同步gradle（点击右上角的Sync Project with Gradle Files按钮）

2. 排查依赖冲突（最常见的原因） #

这个错误90%以上是因为重复引入了同一个库的不同版本，或者完全重复的依赖。你可以这么排查：

• 打开Terminal，在项目根目录运行命令：

  # Mac/Linux
  ./gradlew app:dependencies
  # Windows
  gradlew.bat app:dependencies
  

• 查看输出的依赖树，找有没有同一个库出现多个版本（比如support库、okhttp这类常用库），或者完全重复的依赖项
• 解决方法：要么统一所有依赖的版本号，要么在冲突的依赖里用exclude排除重复部分，比如：

  implementation('com.example.library:xxx:1.0') {
      exclude group: 'com.android.support', module: 'support-v4'
  }
  

3. 确认MultiDex配置是否正确 #

你的compileSdk是27，默认在minSdk>=21时MultiDex是自动开启的，但如果你的minSdk低于21，需要手动配置：

• 在app模块的build.gradle的defaultConfig块里添加：

  defaultConfig {
      // 其他配置...
      multiDexEnabled true
  }
  

• 同时添加MultiDex依赖：

  implementation 'com.android.support:multidex:1.0.3'
  

• 如果有自定义的Application类，让它继承MultiDexApplication；如果不能继承，就在attachBaseContext方法里添加：

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

4. 检查gradle插件与SDK版本兼容性 #

隔了两个月没动项目，可能gradle插件和SDK的版本适配出了问题：

• 确保你的gradle插件版本和compileSdk27匹配，比如用适配27的稳定版插件：

  // 项目根目录的build.gradle里的classpath
  classpath 'com.android.tools.build:gradle:3.2.1'
  

• 打开SDK Manager，确认已经下载了Android 8.1 (API 27)对应的Build Tools和SDK Platform

5. 清理本地gradle缓存 #

如果上面的方法都没用，可能是本地gradle缓存损坏了：

• 删除用户目录下的.gradle/caches文件夹：
  • Mac/Linux：~/Library/Caches/gradle 或 ~/.gradle/caches
  • Windows：C:\Users\你的用户名\.gradle\caches
• 删除后重新打开Android Studio，它会自动重新下载缓存文件，然后同步项目

如果这些方法都没能解决问题，建议你把完整的app模块build.gradle配置贴出来，还有./gradlew app:dependencies的输出结果，这样能更精准地定位冲突点～

内容的提问来源于stack exchange，提问作者Szabó Botond-Ferenc