Missing classes 通常是 R8 在 release 构建中检测到引用但未打包的类，分三类：运行时异常、R8 警告（构建成功）、R8 错误（构建失败）；需结合日志、APK 分析器、--info 日志和 consumer-proguard 配置精准定位，优先补依赖或升级而非盲目 -keep。
Missing classes 通常不是构建失败的直接原因，而是 R8 在 release 构建阶段扫描到某些类被引用但未打包进 APK 导致的警告或错误——它意味着运行时大概率会 ClassNotFoundException。别急着加 -keep，先确认是不是真缺、缺在哪。
看报错上下文：是 R8 报的还是编译期报的？
这两类“missing classes”处理方式完全不同：
- 如果是
java.lang.NoClassDefFoundError或ClassNotFoundException在运行时报出，说明类确实没打进 APK，问题出在依赖链或 R8 规则上 - 如果构建日志里只有
Missing classes detected while running R8这一行（无堆栈），且构建成功，那只是 R8 的静态分析提示，不一定影响运行——但它在 warning 级别时往往预示后续崩溃 - 如果构建直接失败并抛出
R8: Missing class xxx，说明 R8 引用了某个类，但该类既没在源码中定义，也没通过依赖引入，常见于反射、动态加载、或 AAR 内部硬编码了未声明的依赖
检查是否因 AndroidX / Support 库混用导致
这是最隐蔽也最高频的“假 missing”来源：项目已迁移到 AndroidX，但某个 AAR 或老版依赖仍在内部引用 android.support.* 包下的类，而你又没保留兼容桥接。
- 打开 APK 分析器（Build → Analyze APK），查看
classes.dex里是否存在android/support/开头的类；如果不存在，但日志里报 missingandroid.support.v4.app.Fragment，基本就是混用问题 - 确认
gradle.properties中已启用迁移：android.useAndroidX=true和android.enableJetifier=true - 不要手动添加
androidx.legacy:legacy-support-v4之类的老包来“补漏”，这会掩盖真正的问题；应优先升级对应依赖到 AndroidX 版本
定位具体缺失类：用 --info 或 --debug 日志抓 R8 输入
R8 默认不输出缺失类的完整路径，需主动开启详细日志才能看到真正卡在哪：
- 在命令行执行：
./gradlew assembleRelease --info | grep "Missing class" - 或在
gradle.properties中临时加：org.gradle.logging.level=INFO - 关键线索藏在类似这样的行里：
Missing class com.google.common.collect.ImmutableList (referenced from: com.example.MyUtil)—— 这说明MyUtil用了 Guava 的ImmutableList，但 Guava 没作为 compile 依赖引入，只靠传递依赖带入且被裁剪了 - 此时不能只加
-keep class com.google.common.** { *; }，而应补上正经依赖：implementation 'com.google.guava:guava:33.2.1-android'（注意选 -android 后缀版本）
容易被忽略的点：AAR 里的 consumer-rules.pro 被忽略
很多第三方 AAR 会在 libs/xxx.aar!/META-INF/com/android/build/gradle/aar-metadata.properties 里声明自己的 consumer-rules.pro，用于告诉下游项目“哪些类必须保留”。但 AGP 7.0+ 默认不自动合并这些规则。
- 检查你的 AAR 是否包含
META-INF/proguard/目录或aar-metadata.properties文件 - 若存在，需在模块的
build.gradle中显式启用：android { buildFeatures { consumerProguardFiles true } } - 否则 R8 会把 AAR 内部认为必须保留的类当成“未引用”直接移除，报 missing
真正麻烦的 missing classes 往往不在你写的代码里，而在 AAR 的字节码、反射调用链、或跨模块的隐式契约中。别一上来就全局 keep，先让 R8 把话讲完——--info 日志和 APK 分析器比猜更有用。
