Android Studio：参数imageRef未用且Dex合并失败，开MultiDex仍报错

一、处理参数‘imageRef’未被使用的提示 #

这个属于Lint警告，不会直接引发Dex合并失败，但可以顺手搞定：

• 如果这个参数确实用不上，直接删掉它的定义和相关调用就行；
• 如果后续要用到或者不想删，给参数加个@SuppressWarnings("unused")注解，示例代码：

  public void yourTargetMethod(@SuppressWarnings("unused") String imageRef) {
      // 你的方法逻辑
  }
  

• 要是临时想屏蔽这类警告，也能在模块的build.gradle里关闭对应Lint检查（不推荐长期这么做）：

  android {
      lintOptions {
          disable 'UnusedParameter'
      }
  }
  

二、彻底解决Dex合并失败（Error:Execution failed for task ':mobile:transformDexArchiveWithExternalLibsDexMergerForDebug'） #

哪怕开了multiDexEnabled true还是报错，大概率是依赖冲突、重复类或者配置不全导致的，按下面步骤逐一排查：

1. 揪出依赖冲突 #

• 执行命令./gradlew app:dependencies（Windows系统用gradlew.bat app:dependencies）查看完整依赖树，找重复引入的库或者版本不一致的依赖——比如多个库同时引入了同一个类的不同版本，就会触发合并冲突。
• 找到冲突的库后，用exclude排除多余的依赖，示例：

  implementation('com.example:some-third-lib:1.2.3') {
      exclude group: 'com.android.support', module: 'support-v4'
  }
  

• 也可以强制统一依赖版本，在build.gradle的android块下添加：

  configurations.all {
      resolutionStrategy {
          force 'com.android.support:support-v4:28.0.0' // 替换成你项目需要的版本
      }
  }
  

2. 深度清理并重建项目 #

除了常规的Clean Project和Rebuild Project，手动清理缓存能解决很多隐藏问题：

• 删除项目根目录下的.gradle文件夹；
• 删除模块目录下的build文件夹；
• 删除本地Gradle缓存（Windows在C:\Users\你的用户名\.gradle\caches，Mac在~/.gradle/caches）；
• 重启Android Studio，再执行Build > Rebuild Project。

3. 检查MultiDex配置是否完整 #

• 确保你的Application类继承自MultiDexApplication，或者在自定义Application的attachBaseContext方法里初始化MultiDex：

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

• 别忘了在AndroidManifest.xml里指定这个自定义Application：

  <application
      android:name=".MyApp"
      ...>
      ...
  </application>
  

4. 调整Java版本和Dex编译配置 #

• 在build.gradle中指定Java版本为8（或更高，匹配你的SDK版本）：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_1_8
          targetCompatibility JavaVersion.VERSION_1_8
      }
  }
  

• 给Dex编译分配更大堆内存，避免内存不足导致合并失败：

  android {
      dexOptions {
          javaMaxHeapSize "4g" // 可根据电脑配置调整，比如6g
      }
  }
  

5. 排查重复类文件 #

• 检查项目中有没有自己写的类和第三方库类重名；
• 检查libs文件夹下的jar包，是不是和implementation依赖的库重复了（比如同时引入了jar包和Maven依赖的同一个库）。

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