Android 5.0+ DexClassLoader 動態加載失敗：ART 運行時變更與多 Dex 適配

Android 4.x 正常，5.0+ (API 21+) 使用 DexClassLoader 動態加載插件/熱修復 Dex 報錯。核心原因：ART 取代 Dalvik，Dex 文件格式與驗證機制變更。

常見報錯類型

• java.lang.ClassNotFoundException：類找不到
• java.lang.VerifyError：字節碼驗證失敗
• java.lang.IllegalAccessError：訪問權限檢查更嚴格
• dexopt failed：編譯優化失敗

核心變更對比

修復方案清單

1. 應用級 MultiDex 支持（基礎）

// build.gradle
android {
    defaultConfig {
        multiDexEnabled true
    }
}
dependencies {
    implementation "androidx.multidex:multidex:2.0.1"
}

// Application 類
public class MyApp extends MultiDexApplication { // 或手動 install
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        MultiDex.install(this); // 必須在 super 之前或之後調用
    }
}

2. 插件 Dex 合併到主 Dex 列表（關鍵）

ART 要求所有 Dex 文件在加載前註冊到 BaseDexClassLoader 的 dexElements 數組中。

// 反射注入插件 Dex 到主 ClassLoader
public static void injectDex(Context context, String dexPath) throws Exception {
    ClassLoader cl = context.getClassLoader();
    // 1. 獲取 DexPathList
    Field pathListField = findField(cl, "pathList");
    Object dexPathList = pathListField.get(cl);
    
    // 2. 獲取 dexElements 數組
    Field dexElementsField = findField(dexPathList, "dexElements");
    Object[] dexElements = (Object[]) dexElementsField.get(dexPathList);
    
    // 3. 創建新 DexFile
    Class dexFileClass = Class.forName("dalvik.system.DexFile");
    Method loadDexMethod = dexFileClass.getDeclaredMethod("loadDex", String.class, String.class, int.class);
    Object dexFile = loadDexMethod.invoke(null, dexPath, new File(context.getCacheDir(), "opt").getAbsolutePath(), 0);
    
    // 4. 創建 Element 對象 (藉用構造函數)
    Class elementClass = dexElements.getClass().getComponentType();
    Constructor constructor = elementClass.getConstructor(dexFileClass, Boolean.TYPE, File.class, DexFile.class);
    Object newElement = constructor.newInstance(null, false, new File(dexPath), dexFile);
    
    // 5. 擴容數組並插入到最前（優先加載）
    Object[] newElements = Arrays.copyOf(dexElements, dexElements.length + 1);
    newElements[0] = newElement;
    System.arraycopy(dexElements, 0, newElements, 1, dexElements.length);
    
    // 6. 設置回去
    dexElementsField.set(dexPathList, newElements);
}

3. 類隔離：避免版本衝突

• 插件與宿主共用類（如支持庫、網絡庫）必須版本一致
• 插件獨有類正常加載
• 若版本不一致 → 單獨 ClassLoader 隔離，但需處理資源訪問、跨 ClassLoader 通信

4. 簽名一致性（V1/V2/V3 簽名）

• Android 7.0+ 強制驗證 Dex 文件簽名與 APK 一致
• 動態下載的 Dex 必須同樣簽名，或使用 虛擬機繞過（如 VirtualXposed 方案）

5. 替代方案：成熟熱修復框架

排查步驟

1. 確認 multiDexEnabled true 並 MultiDex.install()
2. 檢查插件 Dex 是否同樣編譯目標版本 (compileSdk/targetSdk 一致)
3. 用 dexdump 對比宿主/插件類結構、方法簽名
4. 日志打印 ClassLoader.toString() 確認 Dex 路徑已注入
5. 嘗試 Class.forName("plugin.Class", true, pluginClassLoader) 手動加載驗證

Android 5.0+ 動態加載不再是「new DexClassLoader」這麼簡單，MultiDex 注入 + 類隔離 + 簽名一致 是三大核心門檻。