已设置serialVersionUID仍触发InvalidClassException问题排查

你遇到的问题根源是Proguard混淆破坏了手动设置的serialVersionUID，同时重命名了User类，导致反序列化时类信息完全不匹配。

为什么会出现这个问题？ #

默认的Proguard配置不会专门处理实现Serializable接口的类：

• Proguard会自动重命名类（比如你的User类被改成了日志里的com.myproject.h.e），旧序列化数据里记录的是原类名，现在混淆后的类名完全不同，直接触发类不兼容报错。
• 即使你手动设置了serialVersionUID，Proguard默认可能会移除或修改这个静态常量，导致实际运行时的UID和你设置的123L完全不符。

解决步骤 #

1. 让Proguard保留serialVersionUID字段

在你的Proguard规则文件（通常是proguard-rules.pro）中添加以下规则，确保所有实现Serializable接口的类的serialVersionUID不会被混淆或移除：

-keepclassmembers class * implements java.io.Serializable {
    private static final long serialVersionUID;
}

这条规则明确告诉Proguard：对所有实现Serializable的类，保留它们的serialVersionUID静态常量，不做任何修改。

2. 保留User类的完整类名与字段

为了避免类被重命名导致反序列化时找不到对应类，需要添加规则保留你的User类（或整个模型包下的Serializable类）：

# 如果你只想保留特定的User类
-keep class com.yourproject.User implements java.io.Serializable { *; }

# 或者保留整个模型包下的所有Serializable类（更通用）
-keep class com.yourproject.model.** implements java.io.Serializable { *; }

注意：日志里的com.myproject.h.e是混淆后的类名，你需要替换成你实际的User类全限定名。

3. 验证配置并重新打包

添加完规则后，重新编译打包App，测试反序列化旧数据是否正常。如果还有问题，可以检查Proguard的输出文件，确认User类的serialVersionUID确实被保留，类名也没有被重命名。

额外提示 #

• 如果你需要对Serializable类的某些字段进行混淆（比如非序列化字段），可以用transient修饰不需要序列化的字段，Proguard会自动忽略这些字段的序列化相关处理。
• 每次修改Serializable类的结构后，只要保持serialVersionUID不变，旧数据就能正常反序列化（前提是新增的字段有合理的默认值）。

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