ProGuard异常问题：Android项目中特定Model类未被自定义规则保留

这种单个Model类死活不受ProGuard保留规则约束的情况我也踩过坑，大概率是规则细节、类的特性或者模块配置的问题，咱们一步步来排查：

1. 先确认类的实际状态与全限定名 #

• 别靠猜，直接用Android Studio的Build > Analyze APK打开你的release包，找到classes.dex，查看这个问题Model类的实际情况：是被混淆了类名/成员名，还是直接被移除了？
• 核对类的全限定名：有没有可能你写的包名my.domain.models.**和实际编译后的类路径不一致？比如类是内部类（格式为MyModel$InnerModel），或者包名在编译时被修改过？如果是内部类，可以尝试把规则改成：

  -keepclasseswithmembernames class my.domain.models.**$* { *; }
  

• 先给这个类单独加最明确的规则测试，比如：

  -keep class my.domain.models.ProblemModel { *; }
  

  如果这个规则生效，说明之前的通配规则有漏网的地方。

2. 排查ProGuard规则的冲突与优先级 #

• keepclasseswithmembernames的逻辑是保留那些包含指定成员名的类，如果这个Model类是空类，或者成员名被其他规则提前处理了，可能不会匹配。换成更直接的无条件保留规则试试：

  -keep class my.domain.models.** { *; }
  

• 检查有没有其他规则覆盖了这个类：比如是否存在-assumenosideeffects、-dontwarn或者第三方库的ProGuard规则，无意中处理了这个类？可以暂时注释掉其他非必要规则，逐步排查。
• 如果需要保留类名和成员名不被混淆，加上-keepnames增强规则：

  -keepnames class my.domain.models.ProblemModel { *; }
  

3. 检查类的使用场景 #

• 如果这个Model类是通过反射调用的（比如Gson、Room序列化，或者动态类加载），ProGuard可能会认为它未被直接引用而移除。这时候需要明确告诉ProGuard保留它，比如针对序列化场景：

  -keep class my.domain.models.ProblemModel {
      <fields>;
      <init>();
  }
  

• 检查类是否带有@Deprecated等注解，某些情况下ProGuard会优先处理被标记为废弃的类。

4. 模块迁移后的配置检查 #

• 迁移到其他模块后，要确保目标模块的build.gradle正确配置了ProGuard：
  • 如果是library模块，默认minifyEnabled是false，如果开启了混淆，需要在该模块的proguard-rules.pro里也添加保留规则，或者确保主模块的规则能覆盖到子模块的类（通配包名要正确包含子模块的类路径）。
  • 检查目标模块的buildTypes > release配置，是否正确引用了ProGuard文件，并且minifyEnabled为true（如果需要混淆的话）。

先从最明确的单个类保留规则开始测试，确认生效后再逐步排查根源，一般都能解决问题。

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