反射失效的根本原因是混淆重命名了反射依赖的原始名称，解决关键是精准保留反射锚点对应的类、方法或字段，包括自定义类、R类、枚举、注解及第三方库所需元素，并通过mapping.txt、反编译和异常捕获验证规则有效性。

反射失效的核心原因是混淆工具重命名了类、方法或字段名，而反射依赖原始名称运行。解决的关键不是关掉混淆，而是精准保留反射所用的元素。

明确哪些类和成员需要保留

先定位所有被反射调用的地方：比如通过 Class.forName("xxx") 加载的类、用 getDeclaredMethod("xxx") 调用的方法、或通过 R.drawable.class.getDeclaredField("xxx") 访问的资源字段。这些字符串字面量就是“反射锚点”，对应的真实类/方法/字段必须原样保留。

• 若反射访问的是自定义类（如 com.example.User），需保留整个类及其构造器、字段、方法
• 若只调用特定方法（如 getName()），可只保留该方法，减少保留范围
• 资源类（R.*）必须整体保留，否则 R.drawable.xxx 这类引用会直接失败

在混淆配置中添加针对性规则

在 proguard-rules.pro 或 proguard.cfg 中写入对应规则，注意路径要完整、语法要准确：

• 保留整个类及其所有成员：-keep class com.example.User { *; }
• 只保留指定方法：-keepclassmembers class com.example.User { void getName(); }
• 强制保留 R 类（必加）：-keep class **.R$* { *; }
• 保留枚举的特殊方法（如用到 values()）：-keepclassmembers enum * { public static **[] values(); public static ** valueOf(java.lang.String); }
• 保留注解（如果反射依赖注解）：-keepattributes *Annotation*

验证与调试技巧

光写规则不够，必须验证是否生效：

• 打包后用 mapping.txt 查看目标类是否被重命名——没出现在映射文件里，说明已保留成功
• 反编译 APK（用 dex2jar + jd-gui），直接检查混淆后的字节码中类名和方法名是否仍为原始名称
• 开启 -addconfigurationdebugging，ProGuard 会在构建日志中提示缺失的保留规则建议
• 测试时捕获 NoClassDefFoundError 或 NoSuchMethodException 异常，它们直接指向哪个类或方法没被保留

第三方库中的反射也要单独处理

像百度地图、Gson、Retrofit 等库内部大量使用反射，不能只靠 -keep class com.baidu.** { *; } 一刀切：

• 查阅官方文档，确认其要求的保留规则（例如 Gson 需要保留 model 类的无参构造器和字段）
• 对 Parcelable 或 Serializable 类，必须保留字段名和构造器：-keepclassmembers class * implements android.os.Parcelable { public static final android.os.Parcelable$Creator *; }
• 使用 ButterKnife、Dagger 等框架时，生成的代码类名是动态的，需按框架文档添加对应保留规则