启用minifyEnabled后上传Play Store的Gson反序列化空指针崩溃问题

问题根源 #

当开启minifyEnabled=true时，ProGuard/R8会对未配置保护规则的代码进行混淆优化——包括重命名实体类的类名、字段名。而Gson依赖反射机制匹配JSON字段与实体类字段，混淆后字段名称不匹配，直接导致反序列化失败，抛出NullPointerException。

解决方案 #

方案1：用@Keep注解标记实体类/字段

在Gson需要序列化/反序列化的实体类和字段上添加@Keep注解，阻止混淆工具处理这些元素：

import androidx.annotation.Keep;

@Keep
public class LoginResponse {
    @Keep
    public String user_id;
    @Keep
    public String auth_token;
}

@Keep注解会让ProGuard/R8跳过对标注类、方法、字段的混淆、优化和移除操作，确保Gson能正常通过反射找到对应字段。

方案2：在proguard-rules.pro中添加Gson专属混淆规则

打开项目的proguard-rules.pro文件，添加以下规则：

# 保留Gson核心类与反射相关逻辑
-keep class com.google.gson.** { *; }
-keep class com.google.gson.reflect.TypeToken { *; }
-keepattributes Signature

# 保留项目中所有实体类（替换为你的实体类包路径）
-keep class com.yourapp.models.** { *; }

# 保留SerializedName注解及对应字段（如果用了该注解）
-keepattributes *Annotation*
-keepclasseswithmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

• 第一部分规则确保Gson自身的核心逻辑不被混淆；
• 第二部分替换为你项目中存放实体类的实际包路径，保证实体类的字段名不被修改；
• 第三部分如果实体类使用@SerializedName指定JSON与字段的映射关系，需保留该注解及对应字段。

方案3：提前测试混淆后的安装包

生成签名APK/AAB后，先安装到物理设备测试登录流程，避免上传到Google Play后才发现问题：

1. 在Android Studio中选择Build > Generate Signed Bundle/APK；
2. 选择APK或AAB，完成签名配置后生成安装包；
3. 将安装包安装到设备，验证登录功能是否正常，确认Gson反序列化无异常。

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