gson 反序列化时字段全为 null，通常是因为 java 类结构与 json 层级不匹配。本文详解如何通过创建顶层封装类，精准映射多层嵌套 json，确保 taxes、billto 等子对象被正确反序列化。
在你提供的 JSON 中，billingInformation 并非根对象，而是外层的一个字段名，其值才是真正的 BillingInformation 数据。而你直接将整个 JSON 字符串反序列化为 BillingInformation.class，Gson 会尝试将最外层的 { "billingInformation": { ... } } 强行映射到 BillingInformation 的字段上——但外层根本没有 taxes、billTo 等字段，只有 "billingInformation" 这一个 key，因此所有内部字段均无法匹配，全部返回 null。
✅ 正确做法是：严格遵循 JSON 的层级结构定义 Java 类。
你的 JSON 结构为：
{
"billingInformation": { // ← 这是根级字段
"taxes": { ... },
"billTo": { ... },
...
}
}因此，你需要一个顶层封装类（例如 Data 或 Root），它包含一个名为 billingInformation 的字段，类型为 BillingInformation：
public class Data {
@SerializedName("billingInformation")
private BillingInformation billingInformation;
// 必须提供无参构造函数（Gson 反序列化必需）
public Data() {}
public BillingInformation getBillingInformation() {
return billingInformation;
}
public void setBillingInformation(BillingInformation billingInformation) {
this.billingInformation = billingInformation;
}
}然后修改反序列化代码：
String json = new String(Files.readAllBytes(Paths.get(path))); Data data = gson.fromJson(json, Data.class); BillingInformation billingInfo = data.getBillingInformation(); // ✅ 现在不再为 null
⚠️ 同时，请确保你的子类（如 Taxes、BillTo、Items 等）也正确定义，并与 JSON 字段名一致（或通过 @SerializedName 显式标注）。例如：
public class Taxes {
@SerializedName("gst") private double gst;
@SerializedName("hst") private double hst;
// getter/setter...
}? 补充注意事项：
- 所有参与 Gson 反序列化的类必须有无参构造函数（默认即满足）；
- 字段名大小写需与 JSON 严格一致，或统一用 @SerializedName 注解声明；
- 若 items.item 是数组，Items 类中对应字段应为 List
- 类型，且 Item 类需完整定义 hsnCode、description 等字段；
- 推荐启用 GsonBuilder.setLenient() 仅用于调试；生产环境应保持严格模式以捕获格式错误。
通过这种“逐层建模”的方式，Gson 才能准确将 JSON 的每一层键值对映射到对应的 Java 对象字段，彻底解决空值问题。
