动态加载混淆后DEX模块出现AbstractMethodError问题求助

核心原因说明 #

你遇到的AbstractMethodError本质是运行时期待的方法签名和动态dex中实际的方法签名不匹配，ProGuard/R8的混淆/优化导致的签名不一致是最常见诱因，可按以下步骤排查解决： #

排查解决步骤 #

• 1. 补全@Keep注解的生效规则 #

  很多情况下@Keep注解不生效是因为没有在所有模块（主APK+动态dex模块）的proguard-rules.pro中配置注解保留规则，添加以下配置：

  # 保留Keep注解本身
  -keep class androidx.annotation.Keep
  # 保留被@Keep标注的类所有成员
  -keep @androidx.annotation.Keep class * {*;}
  # 保留被@Keep标注的方法
  -keepclasseswithmembers class * {
      @androidx.annotation.Keep <methods>;
  }
  # 保留被@Keep标注的字段
  -keepclasseswithmembers class * {
      @androidx.annotation.Keep <fields>;
  }
  # 保留被@Keep标注的构造方法
  -keepclasseswithmembers class * {
      @androidx.annotation.Keep <init>(...);
  }
  

• 2. 统一跨模块公共类的混淆规则 #

  除了对外暴露的接口方法，方法的参数类型、返回值类型、所有跨模块调用涉及的公共数据类、接口类都必须同时在主APK和动态dex模块的混淆规则中保留，你异常中的返回值z.a就是被混淆的类，需找到该类对应的原类添加@Keep注解，或直接在规则中保留：

  # 替换为你实际的公共类/接口包名
  -keep class com.android.myproject.bean.** {*;}
  # 接口需用-keepinterface保留避免优化
  -keepinterface com.android.myproject.MyInterface {*;}
  

• 3. 修正动态模块的依赖方式 #

  动态dex模块依赖公共接口/公共类时，必须使用compileOnly（Android Gradle 3.0+）关键字声明依赖，禁止使用implementation/api，避免公共类被打包进dex，导致运行时和主APK中已混淆的公共类不是同一份类实例，出现签名不匹配问题：

  dependencies {
      // 正确示例：公共接口只参与编译不打包
      compileOnly project(":public-interface-module")
      // 错误示例：会把公共接口打包进dex
      // implementation project(":public-interface-module")
  }
  

• 4. 签名一致性验证 #

  配置完成后打包，用jadx等反编译工具分别打开主APK和动态dex文件，对比接口方法和实现类的方法签名（包含返回值、参数的全类名），确认完全一致即可解决问题。

内容的提问来源于stack exchange，提问作者Mario Dello Vicario