Android应用启动崩溃java.lang.ClassNotFoundException排查修复

从堆栈可以直接定位：应用启动时系统尝试实例化入口Activity时抛出ClassNotFoundException，本质是系统按照AndroidManifest配置的路径找不到对应的MainActivity类，和业务代码逻辑无关，基本都是配置、打包、混淆环节出的问题。

按优先级从高到低排查即可：

• 第一步先核对Activity类路径
  打开项目里的MainActivity.java文件，看顶部声明的package路径，和AndroidManifest根节点的package属性值是否匹配：比如manifest里package写的是com.xxx.demo，那写.MainActivity就要求MainActivity直接放在com.xxx.demo包下；如果之前重构把MainActivity移到了比如com.xxx.demo.home子包下，manifest里的name必须改成.home.MainActivity，或者直接写全限定类名。这是新手最容易踩的坑，移动文件后IDE有时候不会自动更新manifest配置。
• 第二步排查混淆导致的类丢失
  如果打release包开启了代码混淆（R8/ProGuard），没有配置keep规则的话，Activity类会被混淆改名，系统按原类名找自然找不到。
  1. 先打开app模块下的build.gradle，看release构建类型里的minifyEnabled是不是设成了true；
  2. 打开proguard-rules.pro文件，添加如下规则保证四大组件不被混淆：

  -keep public class * extends android.app.Activity
  -keep public class * extends androidx.appcompat.app.AppCompatActivity
  -keep public class * extends android.app.Service
  -keep public class * extends android.content.BroadcastReceiver
  -keep public class * extends android.content.ContentProvider
  

  3. 测试阶段可以临时把minifyEnabled设为false打包，如果不崩溃了就确定是混淆规则的问题，补全规则即可。
• 第三步排查MultiDex多分包问题
  如果项目方法数超过65536开启了多分包，且minSdkVersion设置小于21（对应Android 5.0以下系统），没配置MultiDex的话主dex外的类不会被加载，直接报类找不到。
  修复步骤：
  1. 在app模块build.gradle的defaultConfig块里添加multiDexEnabled true
  2. 在dependencies块里添加依赖implementation 'androidx.multidex:multidex:2.0.1'
  3. 如果没有自定义Application类，直接在manifest的<application>标签加属性android:name="androidx.multidex.MultiDexApplication"；如果有自定义Application，就让这个类继承MultiDexApplication即可。
• 第四步排查AAB上传配置问题
  如果是上传aab格式到Google Play，检查是不是开了功能模块按需下载，把MainActivity所在的模块设成了非首装加载模块，导致启动时类还没下发。另外本地构建出安装包后，一定要先拿真机安装测试启动正常，再上传到Play后台，不要直接传构建产物。
• 第五步排查IDE缓存异常
  有时候Android Studio缓存损坏会导致打包时漏编类，在Mac顶部菜单栏点File -> Invalidate Caches...，勾选所有选项清除缓存重启，之后执行Build -> Clean Project再重新构建测试即可。

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