本文介绍如何在 GSON 中为嵌套 POJO（如 Book）实现字段级默认值逻辑——当 JSON 缺失 description 字段时，自动回退使用 title 值填充，避免 @SerializedName 的局限性，核心依赖自定义 JsonDeserializer。
本文介绍如何在 gson 中为嵌套 pojo（如 `book`）实现字段级默认值逻辑——当 json 缺失 `description` 字段时，自动回退使用 `title` 值填充，避免 `@serializedname` 的局限性，核心依赖自定义 `jsondeserializer`。
在使用 GSON 解析 JSON 到 Java 对象时，@SerializedName 仅用于字段名映射（如将 JSON 的 "desc" 映射到 Java 的 description 字段），无法处理缺失字段的默认值逻辑。要实现“若 description 不存在，则用 title 值填充”的业务规则，必须借助 自定义反序列化器（JsonDeserializer
以下是一个完整、可直接运行的解决方案，聚焦于 Book 类的定制化解析：
✅ 核心实现：BookDeserializer
public static class BookDeserializer implements JsonDeserializer<book> {
@Override
public Book deserialize(JsonElement json, Type typeOfT, JsonDeserializationContext context) {
JsonObject obj = json.getAsJsonObject();
// 必须存在的字段：title（假设 JSON 中 title 总是存在）
String title = obj.get("title").getAsString();
// 可选字段：description，缺失时 fallback 到 title
String description = Optional.ofNullable(obj.get("description"))
.map(JsonElement::getAsString)
.orElse(title);
return new Book(title, description);
}
}</book>
? 关键点说明：
- 使用 Optional 安全提取 description，避免空指针；
- obj.get("description") 返回 null 表示该字段完全不存在（而非 null 值），因此需判空后取值；
- 构造 Book 实例时完成逻辑兜底，保持领域对象数据完整性。
✅ 注册与使用
在构建 Gson 实例时，通过 GsonBuilder.registerTypeAdapter() 将 Book.class 绑定到自定义解析器：
Gson gson = new GsonBuilder()
.registerTypeAdapter(Book.class, new BookDeserializer())
.create();
// 输入为 BookList 数组格式（注意原始 JSON 是数组）
BookList[] bookLists = gson.fromJson(jsonString, BookList[].class);
⚠️ 注意事项与最佳实践
- 抽象类限制：原问题中 BookList 和 Book 均为 abstract class，但 GSON 默认无法实例化抽象类。实际开发中建议改用 final class + private 字段 + getter/setter（如示例所示），或配合 @JsonAdapter 在字段级指定解析器。
- 性能考量：自定义解析器无显著性能损耗，适用于绝大多数场景；高频调用时可复用 JsonObject 解析逻辑，避免重复 getAsJsonObject()。
- 可扩展性：若未来需支持更多 fallback 规则（如 description 缺失时查数据库），只需在 deserialize() 方法中增强逻辑，不侵入业务模型。
- 测试建议：务必覆盖两类用例：① description 存在；② description 完全缺失（非 null 值），确保 fallback 行为稳定。
✅ 总结
@SerializedName 是静态映射工具，而字段级默认值属于运行时业务逻辑，必须由 JsonDeserializer 承载。本方案以最小侵入方式，在解析阶段统一补全数据，保障上层代码始终获得符合契约的对象状态——这是构建健壮 JSON API 客户端的关键实践。
