集成Dexguard至启用Multidex的项目时启动崩溃，报错类未找到

我之前在Multidex项目里集成DexGuard时也碰到过一模一样的崩溃问题——编译全程无报错，但一启动就报java.lang.ClassNotFoundException找不到自定义Application类，折腾了好一阵才解决，给你几个排查和修复的方向：

1. 修复DexGuard混淆规则，保留关键类 #

问题大概率是DexGuard的优化/混淆过程中，把你的自定义Application类或者Multidex相关逻辑误标记为"未使用"给移除了。你需要在dexguard-rules.pro（或项目中对应的DexGuard规则文件）里添加以下规则：

# 强制保留你的自定义Application类，包含构造方法和attachBaseContext方法
-keep public class xx.xxx.xxx.XXXApp {
    public <init>();
    protected void attachBaseContext(android.content.Context);
}

# 保留Multidex核心类和方法，避免被优化移除
# 如果你用的是Android Support库
-keep class android.support.multidex.** { *; }
-keepclassmembers class android.support.multidex.** { *; }

# 如果你已经迁移到AndroidX，替换成下面的规则
# -keep class androidx.multidex.** { *; }
# -keepclassmembers class androidx.multidex.** { *; }

注意把xx.xxx.xxx.XXXApp替换成你实际的Application类全路径。

2. 确认Multidex配置完全正确 #

检查你的app.gradle里的Multidex配置是否没有遗漏：

• 确保defaultConfig中启用了Multidex：

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

• 确保依赖了正确的Multidex库：

  dependencies {
      // Support库版本
      implementation 'com.android.support:multidex:1.0.3'
      // AndroidX版本
      // implementation 'androidx.multidex:multidex:2.0.1'
  }
  

• 如果你的自定义Application没有直接继承MultidexApplication，一定要在attachBaseContext方法中手动调用Multidex初始化：

  public class XXXApp extends Application {
      @Override
      protected void attachBaseContext(Context base) {
          super.attachBaseContext(base);
          // 必须在super调用后执行
          Multidex.install(this);
      }
      // 其他业务代码...
  }
  

3. 清理缓存并重新构建 #

有时候Gradle的缓存会导致奇怪的编译残留问题，执行以下命令彻底清理后再重新构建：

./gradlew clean
./gradlew assembleRelease # 或者你需要的构建变体，比如assembleDebug

4. 检查DexGuard版本兼容性 #

确保你使用的DexGuard版本支持当前项目的compileSdkVersion 27，比如DexGuard 8.x及以上版本通常对Android 8.1（API 27）有良好支持，版本不兼容可能会导致类加载路径异常。

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