Android应用新增Data Class参数后旧版本用户是否会崩溃？

一般情况下不会崩溃，但存在几种特定场景可能导致崩溃，下面分情况说明：

Gson的默认行为 #

Gson在反序列化JSON时，默认会忽略JSON中不存在的字段，并且给Data Class里新增的字段赋对应类型的默认值：

• 引用类型（如String、自定义类）赋值为null
• 基本类型（如Int、Boolean）赋值为0、false等

这种默认逻辑下，从SharedPreferences读取旧版本的JSON并反序列化为新版本的Data Class，不会直接抛出异常。

可能导致崩溃的场景 #

• 新增字段为非空类型且无默认值：比如Kotlin中声明val newRequiredField: String（没有?也没有默认值），Gson反序列化时找不到这个字段会尝试赋值null，但非空类型不允许null，会直接抛出NullPointerException或JsonSyntaxException，引发崩溃。
• 业务代码未处理新增字段的空值：即使新增字段是可空类型（如val newField: String?），但如果业务代码直接调用其方法（如newField.length()），没有先判空，就会触发空指针崩溃。
• 自定义了严格的Gson反序列化策略：如果你的Gson实例是通过GsonBuilder().setStrictness(Strictness.STRICT)或类似配置开启了严格字段匹配，或者自定义了TypeAdapter要求必须包含所有字段，那么反序列化旧JSON时会因为缺少新增字段抛出异常。
• 新增字段为复杂非空类型：如果新增的字段是另一个Data Class，且这个嵌套类同样是无默认值的非空类型，反序列化时会因为无法实例化这个嵌套类而抛出异常。

避免崩溃的建议 #

• 新增字段时优先声明为可空类型，或者给非空字段设置合理的默认值（如val newField: String = ""、val newCount: Int = 0）。
• 在使用新增字段的业务逻辑中，先做判空或默认值校验，比如用newField ?: "默认值"处理可空字段。
• 保持Gson的默认宽松配置，不要随意开启严格字段匹配规则。
• 给新增字段添加@SerializedName注解明确指定JSON字段名，避免因Kotlin和Java命名规则差异（如驼峰转下划线）导致的字段匹配问题。

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