genericsignatureformaterror 是 jvm 加载类时因泛型签名（signature 属性）非法或缺失抛出的 classformaterror 子类，常见于 r8 混淆未保留 -keepattributes signature 导致泛型元数据损坏，运行时首次加载类即崩溃且无源码行号。
GenericSignatureFormatError 在 Android 开发中通常不是代码逻辑问题，而是 R8 混淆后泛型签名（Signature attribute）被破坏导致的类加载失败。它不报在编译期，而是在运行时首次加载某个类（比如通过反射、new 实例、或访问泛型成员）时触发，堆栈里往往只显示 defineClass 或 loadClass，没有你的源码行号——这正是它难定位的关键。
R8 为什么会搞坏泛型签名
R8 默认会移除 Signature 属性，除非你明确要求保留。这个属性是 JVM 解析泛型信息（如 List<string></string>、<t extends view></t>）的依据。一旦被删或写错格式，JVM 加载类时就会抛 GenericSignatureFormatError。
- R8 的压缩阶段若未保留 Signature 属性，会导致泛型元数据丢失
- 混淆阶段若对泛型类型名做了非法重命名（如把
MyCallback<user></user>改成a<b></b>但没同步更新 Signature 字段），签名字符串就变成非法语法 - 跨 JDK 版本编译（如用 JDK 17 编译 + JDK 8 运行）也可能因签名格式差异引发该错误
必须加的 keep 规则：-keepattributes Signature
这是最直接有效的修复手段。R8 不会自动保留泛型签名，必须显式声明：
Android Adb Skill
下载
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
- 在
proguard-rules.pro或consumer-rules.pro中添加：
-keepattributes Signature - 如果项目使用了 Kotlin，还需补充：
-keepattributes Signature,Annotation,Exceptions,InnerClasses,EnclosingMethod
（Kotlin 泛型和内联函数更依赖完整属性） - 对特定类或包加强保护（可选）：
-keep class com.example.** { *; }
-keepattributes Signature
验证签名是否真的生效
加完规则不能只靠“感觉”，得实锤验证：
- 构建 release 包后，解压 APK，找到对应 class 文件：
unzip -p app-release.apk classes.dex | dex2jar.sh -f -o classes.jar（或用 jadx-gui 直接打开） - 反编译出 class 后，用
javap -v ClassName查看输出中是否有Signature:行，且内容为合法泛型描述（如Signature: Ljava/lang/Object;Ljava/io/Serializable;Ljava/lang/Comparable<lclassname>;;</lclassname>） - 若无 Signature 行，或内容为乱码、空值、明显非法结构（如缺分号、尖括号不匹配），说明规则未生效或被其他配置覆盖
排查第三方库带来的签名污染
很多崩溃其实不出在你自己写的类，而是某个 aar 或 jar 里的 class 已被破坏：
- 用
./gradlew :app:dependencies --configuration releaseRuntimeClasspath查看实际参与构建的依赖树 - 重点检查近期升级或新引入的 SDK，尤其是带泛型回调、注解处理器、或自定义 ClassLoader 的库
- 对可疑库，在其
consumer-rules.pro中强制补全：
-keepattributes Signature
（可通过android.useAndroidX=true和android.enableJetifier=true确保旧支持库也能被正确转换）
