gson 反序列化时若 json 存在顶层包装字段（如 `"billinginformation": { ... }`），而直接映射到 `billinginformation.class`，会导致所有字段为 null；必须定义与 json 结构完全匹配的封装类（如 `data`），再从中提取目标对象。
你遇到的问题是典型的 JSON 结构与 Java 类结构不匹配 导致的反序列化失败。观察你的原始 JSON：
{
"billingInformation": {
"taxes": { "gst": 2.5, "hst": 7.8 },
"billTo": { "name": "Mike", ... },
"salesAgent": { "name": "Charlotte Thompson", ... },
"items": { "item": [...], "currency": "USD" }
}
}该 JSON 的根对象是一个键为 "billingInformation" 的单字段对象，而非直接以 BillingInformation 的字段为根。但你却执行了：
BillingInformation billingInformation = gson.fromJson(result, BillingInformation.class);
这等价于让 Gson 尝试将整个 JSON（含外层 { "billingInformation": { ... } }）强行映射到 BillingInformation 实例——而 BillingInformation 类中并没有名为 billingInformation 的字段，因此 Gson 无法匹配任何属性，所有嵌套字段（taxes、billTo 等）均被忽略，最终全部为 null。
✅ 正确做法：严格遵循 JSON 层级定义封装类
你需要一个顶层类 Data（或任意命名，如 Root），其唯一字段 billingInformation 对应 JSON 中的同名键：
public class Data {
@SerializedName("billingInformation")
private BillingInformation billingInformation;
// 必须提供 getter，否则无法访问
public BillingInformation getBillingInformation() {
return billingInformation;
}
}然后按如下方式解析：
String json = new String(Files.readAllBytes(Paths.get(path))); Data data = gson.fromJson(json, Data.class); BillingInformation billingInfo = data.getBillingInformation(); // ✅ 此时不再为 null
? 补充说明与最佳实践：
- 字段命名一致性：@SerializedName 在字段名与 JSON key 完全一致时可省略（如 billingInformation → "billingInformation"），但建议显式标注以增强可读性与健壮性。
- 嵌套类完整性：确保 Taxes、BillTo、SalesAgent、Items 等子类也正确定义了对应字段及 getter/setter，并与 JSON 键名精确匹配（区分大小写）。
-
空值安全：可在 Data 类中添加空值检查：
if (data == null || data.getBillingInformation() == null) { throw new IllegalStateException("Failed to parse billing information from JSON"); } -
避免常见陷阱：
- ❌ 不要省略顶层封装类，试图“跳过一层”；
- ❌ 不要将 gson.fromJson(..., BillingInformation.class) 用于带包装的 JSON；
- ✅ 使用 JsonPath 或在线工具（如 jsoneditoronline.org）预览 JSON 结构，确认层级关系。
通过严格对齐 JSON 树形结构与 Java 类层次，Gson 即可准确完成反序列化——这是使用任何 JSON 库（Jackson、Moshi 等）都需遵守的核心原则。
