启用ProGuard时Gson发生崩溃问题求助

我之前在项目里也踩过Gson+ProGuard的坑，结合你描述的情况——已经给实体类加了@SerializedName注解，配置了部分ProGuard规则但还是崩溃，而且你给出的规则明显没写完，大概率是规则缺失导致的，咱们来一步步排查和解决：

首先补全你未写完的ProGuard规则 #

你写到一半的那部分规则是用来保护Gson的核心接口实现类的，ProGuard默认会剥离这些接口信息，导致Gson无法正常识别序列化/反序列化的适配器，这是常见的崩溃原因。完整的规则应该补上：

# Prevent proguard from stripping interface information from TypeAdapterFactory,
# JsonSerializer, JsonDeserializer instances (so they can be used in @JsonAdapter)
-keep class * implements com.google.gson.TypeAdapterFactory
-keep class * implements com.google.gson.JsonSerializer
-keep class * implements com.google.gson.JsonDeserializer

检查实体类的ProGuard规则是否覆盖全面 #

你已经加了-keep class com.smartmedia.musicplayer.api.AppSetting { *; }来保留实体类，但要注意几个细节：

• 如果AppSetting包含内部类（比如静态内部类的子实体），这个规则不会覆盖内部类，需要改成：

  -keep class com.smartmedia.musicplayer.api.AppSetting** { *; }
  

• 如果你想更精准地只保留带@SerializedName注解的字段（避免保留不必要的字段），可以替换成：

  -keepclassmembers class com.smartmedia.musicplayer.api.AppSetting {
      @com.google.gson.annotations.SerializedName <fields>;
  }
  

排查其他可能的崩溃诱因 #

1. 关联实体类被混淆：如果AppSetting里引用了其他自定义实体类，这些类也需要添加对应的-keep规则，否则Gson解析时找不到类会抛出异常。
2. GsonBuilder配置冲突：如果你用GsonBuilder创建Gson实例时开启了excludeFieldsWithoutExposeAnnotation()，那要确保所有需要序列化/反序列化的字段都加了@Expose注解，否则会被ProGuard和Gson双重过滤，导致解析失败。
3. 查看崩溃日志：最关键的是看具体的崩溃栈信息——比如是NoSuchFieldException（字段被混淆）、ClassCastException（类型转换错误）还是JsonSyntaxException（解析格式问题），根据错误信息能更快定位问题。

推荐的完整Gson ProGuard规则 #

把这些整合起来，给你一套完整的规则参考：

# Gson基础规则
-keepattributes *Annotation*
-dontwarn sun.misc.**
-keep class com.google.gson.stream.** { *; }
-keepattributes EnclosingMethod

# 保护Gson核心接口实现类
-keep class * implements com.google.gson.TypeAdapterFactory
-keep class * implements com.google.gson.JsonSerializer
-keep class * implements com.google.gson.JsonDeserializer

# 保留你的实体类及内部类
-keep class com.smartmedia.musicplayer.api.AppSetting** { *; }

# 可选：精准保留带SerializedName注解的字段
# -keepclassmembers class com.smartmedia.musicplayer.api.AppSetting {
#     @com.google.gson.annotations.SerializedName <fields>;
# }

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