Gradle构建APK过小，出现ClassNotFoundException与NoClassDefFoundError求助

这种因代码缩减导致的运行时异常真的很磨人，尤其是还和第三方依赖挂钩的时候，我来帮你一步步排查解决：

1. 先锁定Debug构建的缩减配置细节 #

你提到关闭minifyEnabled true后恢复正常，但加库后又出问题，先仔细检查debug构建块的完整配置，别漏了其他可能触发缩减的开关：

android {
    buildTypes {
        debug {
            minifyEnabled false
            shrinkResources false // 这个开关如果开启，哪怕minify关了也可能删除资源甚至影响类引用
            useProguard false // 强制禁用ProGuard，用R8的debug友好模式
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

另外，确认有没有不小心把debug和release的配置搞混，比如误把release的缩减规则套用到debug上。

2. 排查新增第三方库的问题 #

大概率是你添加的这个库触发了意外的代码缩减，按以下步骤排查：

• 先暂时移除这个库，重新构建Debug APK，看大小是否恢复到2MB左右，确认是这个库导致的问题。
• 如果确认是该库，去它的官方文档/ README里找有没有要求添加特定的R8/ProGuard规则——很多第三方库（尤其是带动态加载、反射逻辑的）需要保留特定类，不然会被R8自动删掉。
• 在proguard-rules.pro里添加针对该库的保留规则，比如：

  // 替换成你添加的库的包名
  -keep class com.example.targetlibrary.** { *; }
  -keep interface com.example.targetlibrary.** { *; }
  -keep enum com.example.targetlibrary.** { *; }
  

3. 彻底清理构建缓存（比常规清理更彻底） #

你已经做了基础清理，但有时候缓存残留会导致配置不生效，试试这些操作：

• 在Android Studio里执行 File > Invalidate Caches... > Invalidate and Restart，重启后再构建。
• 用命令行执行深度清理：

  # Mac/Linux
  ./gradlew clean build --no-build-cache
  # Windows
  gradlew.bat clean build --no-build-cache
  

4. 分析异常APK，精准定位缺失类 #

如果上面的方法都没解决，直接分析APK内容找问题：

1. 打开Android Studio，选择 Build > Analyze APK，导入那个980KB的Debug APK。
2. 查看classes.dex里的类结构，对比正常的2MB APK，看看哪些包/类消失了。
3. 根据缺失的类，针对性添加保留规则到proguard-rules.pro里。

核心原因总结 #

你的问题本质是Debug构建中意外触发了代码缩减（要么是配置漏项，要么是第三方库的默认规则导致），R8/ProGuard把运行时必需的类给移除了，才会出现ClassNotFoundException，同时APK因为大量类被删除而缩小。

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