使用Volley构建Android项目时遭遇Dex合并失败错误求助

嘿，我之前在集成Volley的时候也碰到过完全一样的Dex合并错误，真的挺头疼的。这个错误一般是依赖重复、版本冲突或者Dex方法数超限导致的，咱们一步步来排查解决：

首先先明确你遇到的错误：

Error:Execution failed for task ':app:transformDexArchiveWithExternalLibsDexMergerForDebug'. java.lang.RuntimeException: com.android.builder.dexing.DexArchiveMergerException: Unable to merge dex

常见解决方案： #

1. 检查Volley依赖是否重复

很多人会犯这个错：既在libs目录放了Volley的jar包，又在Gradle里添加了远程依赖。这样会导致同一个类被多次打包，直接触发Dex合并失败。

• 如果你用远程依赖，就删掉libs里的Volley jar，然后在dependencies里添加正确的Volley依赖（建议用最新稳定版）：

  implementation 'com.android.volley:volley:1.2.1'
  

• 如果你坚持用本地jar，就确保Gradle里没有重复的远程依赖。

2. 排查依赖冲突

项目里的不同依赖可能会引用同一个库的不同版本，比如Volley可能依赖的support库和你项目里的appcompat-v7:26.1.0版本不一致，这就会导致冲突。

• 运行命令查看项目的依赖树：

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

• 找到冲突的库（比如不同版本的com.android.support），然后用exclude排除冲突的模块，比如：

  implementation 'com.android.volley:volley:1.2.1' {
      exclude group: 'com.android.support' // 排除Volley自带的support依赖，用你项目里的版本
  }
  

• 另外要确保所有support相关的依赖版本统一，比如你用了appcompat-v7:26.1.0，那其他像design、cardview这些库也要用26.1.0版本。

3. 启用MultiDex（方法数超限场景）

如果你的项目里方法总数超过了65536的Dex限制，也会触发这个错误。这时候需要开启MultiDex：

• 在app模块的build.gradle里配置：

  android {
      defaultConfig {
          // 其他配置...
          multiDexEnabled true
      }
  }
  
  dependencies {
      // 其他依赖...
      implementation 'com.android.support:multidex:1.0.3'
  }
  

• 然后处理Application类：
  • 如果你的项目没有自定义Application，就在AndroidManifest.xml里指定MultiDexApplication：

    <application
        android:name="android.support.multidex.MultiDexApplication"
        // 其他配置...>
    </application>
    

  • 如果有自定义Application，让它继承MultiDexApplication，或者在attachBaseContext方法里初始化：

    public class MyApp extends Application {
        @Override
        protected void attachBaseContext(Context base) {
            super.attachBaseContext(base);
            MultiDex.install(this);
        }
    }
    

4. 清理缓存并重建项目

有时候只是缓存导致的问题，试试这些操作：

• 点击Android Studio顶部菜单的Build -> Clean Project，然后Build -> Rebuild Project
• 手动删除项目根目录的.gradle文件夹和app模块的build文件夹，然后重新同步Gradle

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