API<21设备多DEX环境下NoClassDefFoundError问题求助

结合你描述的情况——Release APK在全设备正常、仅Debug版在API 19崩溃且已启用Multidex，这个问题大概率和Debug模式下的Multidex配置、构建缓存或者代码优化规则有关，给你几个具体的排查和解决方向：

• 确认Debug变体的Multidex配置是否完整
  有时候我们可能只给Release模式开启了Multidex，却忽略了Debug模式。打开模块级的build.gradle，确保Debug构建类型下也启用了Multidex：

  android {
      buildTypes {
          debug {
              multiDexEnabled true
              // 其他Debug相关配置
          }
          release {
              multiDexEnabled true
              // 你的Release配置
          }
      }
  }
  

  同时检查你的Application类：要么继承MultiDexApplication，要么在attachBaseContext方法中调用MultiDex.install(this)，并且不要通过BuildConfig.DEBUG把这段逻辑给屏蔽掉。

• 强制指定主dex必须包含的类
  API 19的Multidex机制有局限性，部分核心类必须打包进主dex才能被正确加载。你可以通过配置文件强制将崩溃时缺失的类加入主dex：

  1. 在模块根目录创建multidex_keep.txt文件，写入缺失类的路径（比如com/example/MyMissingClass.class）
  2. 在build.gradle的Debug构建类型中添加：

     debug {
         multiDexKeepFile file('multidex_keep.txt')
     }
     

  如果有需要通过ProGuard规则保留的类，也可以创建multidex_keep.pro文件，用ProGuard语法声明，再通过multiDexKeepProguard配置引入。

• 清理构建缓存并重新编译
  Android Studio的构建缓存偶尔会导致Debug构建异常，试试以下步骤：

  1. 执行File -> Invalidate Caches... -> Invalidate and Restart
  2. 删除项目根目录的.gradle文件夹和模块下的build文件夹
  3. 重新执行Clean Project和Rebuild Project

• 排查第三方依赖的Debug兼容性
  部分第三方库在Debug模式下对API 19的Multidex支持不佳，你可以尝试暂时移除最近新增的依赖，或者替换为兼容版本，看是否能定位到问题根源。

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