如何解决ASM Instrumentation无法解析部分类的问题？

问题场景 #

执行./gradlew assembleRelease构建Release包时，AGP 8.0.1抛出ASM插桩相关警告：

ASM Instrumentation process wasn't able to resolve some classes, this means that
the instrumented classes might contain corrupt stack frames. Make sure the
dependencies that contain these classes are on the runtime or the provided
classpath. Otherwise, the jvm might fail to load the corrupt classes at runtime
when running in a jvm environment like unit tests.

Classes that weren't resolved:

sun.misc.Unsafe
androidx.appcompat.view.ContextThemeWrapper
com.google.common.util.concurrent.ListenableFuture
retrofit2.Response
javax.mail.internet.MimeBodyPart
javax.naming.NamingException
javax.naming.directory.Attributes

在AGP 7.4.2版本中，警告表现为"找不到公共父类"的形式，例如：

Unable to find common super type for java/lang/reflect/Field and sun/misc/Unsafe.
Unable to find common super type for androidx/appcompat/view/ContextThemeWrapper and android/content/Context.
...（其他重复类对的警告）

核心原因 #

这类警告本质是AGP的ASM字节码插桩过程中，无法在类路径中找到某些依赖类的定义，导致插桩时无法生成合法的栈帧。AGP 8.0+对插桩错误提示做了优化，将之前分散的"找不到公共父类"提示统一为更清晰的"类无法解析"信息。

针对性解决方案 #

1. Android官方库类（如androidx.appcompat.view.ContextThemeWrapper） #

• 确保androidx.appcompat:appcompat依赖已正确加入implementation配置，使用与AGP 8.0.1兼容的稳定版本：

  implementation 'androidx.appcompat:appcompat:1.6.1'
  

• 执行./gradlew clean清除构建缓存后重新构建，避免缓存导致的依赖路径异常。

2. 第三方库类（如retrofit2.Response、com.google.common.util.concurrent.ListenableFuture） #

• 检查对应依赖是否存在，缺失则补充：
  • Retrofit：implementation 'com.squareup.retrofit2:retrofit:2.9.0'（或更高兼容版本）
  • Guava ListenableFuture：若项目使用Guava，添加implementation 'com.google.guava:guava:32.1.3-android'；若关联WorkManager，确保androidx.work:work-runtime依赖正确引入
• 若依赖已存在，升级到与AGP 8.0.1兼容的版本，避免版本不匹配导致的类路径问题。

3. JDK/Java EE类（如sun.misc.Unsafe、javax.mail.*、javax.naming.*） #

• sun.misc.Unsafe：这是JDK内部API，Android运行时不直接暴露，部分第三方库会通过反射使用。添加compileOnly依赖让ASM能找到类定义：

  compileOnly 'org.apache.commons:commons-lang3:3.12.0'
  

• javax.mail.*和javax.naming.*：属于Java EE类，Android默认不包含。若项目需要相关功能，添加兼容库；若仅为第三方库间接依赖，用compileOnly引入即可（无需打包到APK）：

  compileOnly 'com.sun.mail:android-mail:1.6.7'
  compileOnly 'javax.naming:naming:1.0.1'
  

4. 排除第三方库的不必要插桩 #

如果警告来自Firebase、Recaptcha等第三方库的内部字节码处理，且确认不影响运行时，可通过AGP配置排除特定包的插桩：

android {
  buildTypes {
    release {
      instrumentation {
        exclude 'com.google.android.gms.internal.**'
        exclude 'com.google.android.recaptcha.internal.**'
      }
    }
  }
}

5. 升级AGP到最新稳定版 #

AGP 8.0.x后续版本可能修复了部分插桩的类路径问题，尝试升级到8.1.x或更高稳定版，看是否自动解决警告。

验证步骤 #

处理完成后，重新执行./gradlew assembleRelease检查警告是否消失。若仍存在，可通过./gradlew dependencies查看依赖树，确认相关类的依赖是否已加入runtime或compileOnly类路径。

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