Gson嵌套反序列化失败主因是字段名不匹配，需用@SerializedName或FieldNamingPolicy；泛型解析须用TypeToken；空字段需自定义JsonDeserializer；Gson应全局单例且线程安全。
嵌套对象反序列化失败：字段名不匹配导致 null
Java 用 Gson 解析含多层嵌套的 JSON 时，最常见问题是字段名大小写或命名风格不一致，导致嵌套对象内部字段全为 null。Gson 默认严格按 Java 字段名映射，不会自动处理下划线转驼峰（如 user_name → userName）。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确认 JSON 字段名与 Java 类字段名完全一致；不一致时，必须显式标注
@SerializedName("user_name") - 全局启用下划线转驼峰：构建
Gson实例时加GsonBuilder().setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES) - 避免在嵌套类里混用命名策略——父类设了策略，子类字段仍需单独加
@SerializedName覆盖，否则策略不递归生效
泛型嵌套集合解析：List<Map<String, Object>> 怎么写 TypeToken
直接用 gson.fromJson(json, List.class) 会丢失泛型信息，解析出的其实是 ArrayList<LinkedTreeMap>，无法安全强转成 Map<String, String> 或访问具体字段。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 必须用
TypeToken显式声明完整类型：new TypeToken<list object>>>() {}.getType()</list> - 如果嵌套更深（比如
List<Response<Data>>），TypeToken 写法要逐层展开，漏一层就出错 - 别把
TypeToken存成常量——它依赖匿名内部类，序列化/反射场景下可能抛NotSerializableException或NullPointerException
自定义反序列化器（JsonDeserializer）绕过空值或缺失字段
当 JSON 中某个嵌套对象字段可能为 null 或干脆不存在，而 Java 类里又没加 @Nullable 或默认构造逻辑，Gson 默认会抛 JsonParseException 或让整个对象解析失败。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 写一个实现
JsonDeserializer<YourClass>的类，在deserialize()里手动检查jsonElement.isJsonObject()和字段是否存在 - 注册时用
GsonBuilder().registerTypeAdapter(YourClass.class, new YourDeserializer())，注意注册顺序：先注册再 build - 别在 deserializer 里调
gson.fromJson(subJson, SubClass.class)时传入同一个Gson实例——容易触发递归注册报错，改用context.deserialize(subJson, SubClass.class)
性能陷阱：重复创建 Gson 实例 vs 全局单例
很多人图省事在方法里 new Gson()，但 Gson 构造开销不小，尤其启用了 setDateFormat、registerTypeAdapter 等配置后，每次 new 都要重建反射缓存和类型适配器表。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 除非需要隔离配置（比如一个模块要忽略 null，另一个要输出 null），否则一律用静态 final 单例：
private static final Gson GSON = new GsonBuilder().create(); - 如果要用多个配置变体，用
GsonBuilder.clone()复制后再微调，比从头 new 更轻量 - 注意
Gson实例不是线程安全的？错——官方文档明确说它是线程安全的，可放心共享
嵌套越深，TypeToken 写错、字段名策略漏配、自定义反序列化器里 context 用错的情况就越隐蔽。这些地方不报编译错误，但运行时数据就悄悄丢了一层。
