GenericSignatureFormatError 混淆修复：分析在 Android 开发中 R8 工具处理异常变量签名时的常见 Bug

必须加的 keep 规则：-keepattributes Signature

解决方案其实很直接，但偏偏很多人忘了做这一步。-keepattributes Signature 这条规则，是 R8 不会自动帮你保留的属性，你得在 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 打开
• 反编译后，用 ja vap -v ClassName 看看输出里有没有 Signature: 这一行。合法的签名长什么样？大概是这样的：Signature: Lja va/lang/Object;Lja va/io/Serializable;Lja va/lang/Comparable;;
• 如果看不到 Signature 行，或者看到的是一串乱码、空值、缺分号、尖括号不匹配，那就说明规则没生效，或者被其他配置覆盖了

排查第三方库带来的签名污染

说实话，不少崩溃压根儿不是你自己代码的锅，而是某个 aar 或 jar 里的 class 早就“中招”了。这时候你得学会查依赖：

• 用 ./gradlew :app:dependencies --configuration releaseRuntimeClasspath 看实际参与构建的依赖树
• 重点检查近期升级或刚引入的 SDK，尤其是那些带泛型回调、注解处理器、或者自定义 ClassLoader 的库
• 如果发现哪个可疑库，直接在它的 consumer-rules.pro 里强制补上这条规则：-keepattributes Signature
  （另外，别忘了用 android.useAndroidX=true 和 android.enableJetifier=true 确保旧支持库也能被正确转换）