本文详解在使用 gson 解析嵌套 json 时，如何避免因访问不存在的属性（如 fields.category）导致的 nullpointerexception，并提供健壮、可复用的空值处理方案。
本文详解在使用 gson 解析嵌套 json 时，如何避免因访问不存在的属性（如 fields.category）导致的 nullpointerexception，并提供健壮、可复用的空值处理方案。
在 Java 中使用 Gson 解析动态结构的 JSON 数据时，一个常见陷阱是：当目标字段（如 `"category"`）在原始 JSON 中完全缺失（而非显式为 `null`）时，调用 `JsonObject.get("key")` 会返回 `null`，而非 `JsonNull` 实例。此时若直接将该 `null` 值传入依赖 `isJsonNull()` 判断的方法（如示例中的 `getValue()`），就会触发 `NullPointerException`——因为 `null.isJsonNull()` 是非法操作。根本原因在于 Gson 的设计约定：
- JsonObject.get("missingKey") → 返回 null（Java null，非 JSON null）
- JsonObject.get("nullKey") → 返回 JsonNull.INSTANCE（Gson 的 JSON null 类型）
因此，安全的字段提取必须同时校验 Java null 和 JSON null。以下是优化后的完整解析实现：
import com.google.gson.*;
public class DataParser {
public static JsonArray parseData(JsonArray data) throws JsonParseException {
JsonArray dataArray = new JsonArray();
for (JsonElement dataObj : data) {
if (!dataObj.isJsonObject()) continue;
JsonObject obj = dataObj.getAsJsonObject();
JsonObject finalDataObj = new JsonObject();
// 安全提取顶层字段
finalDataObj.add("key", obj.get("key"));
// 安全提取嵌套 fields 对象
JsonElement fieldsElement = obj.get("fields");
JsonObject fieldsObj = (fieldsElement != null && fieldsElement.isJsonObject())
? fieldsElement.getAsJsonObject()
: new JsonObject(); // 空对象兜底，避免后续 NPE
// 使用增强版 getValue() 处理缺失/空值
finalDataObj.addProperty("cityName", getValue(fieldsObj.get("cityName")));
finalDataObj.addProperty("category", getValue(fieldsObj.get("category")));
dataArray.add(finalDataObj);
}
return dataArray;
}
// ✅ 关键修复：先判空再判 JsonNull
public static String getValue(JsonElement fieldValue) {
if (fieldValue == null || fieldValue.isJsonNull()) {
return "";
}
return fieldValue.getAsString();
}
}✅ 关键改进点说明：
- getValue() 方法新增 fieldValue == null 判断，彻底规避 NullPointerException；
- 在获取 fields 前增加 null 检查，并在 fields 不存在时提供空 JsonObject 作为默认值，防止后续 getAsJsonObject() 报错；
- 对输入 dataObj 增加 isJsonObject() 校验，提升鲁棒性；
⚠️ 注意事项：
- 不要依赖 JsonObject.has("key") 作为唯一判断依据——它仅表示字段存在（含 null 值），但 get("key") 仍可能返回 null；
- 若需区分“字段缺失”与“字段为 null”，应结合 has() + get() 双重判断；
- 生产环境建议封装为通用工具类（如 JsonUtils.safeGetString(obj, "path.to.field", "")），支持点号路径和默认值；
通过以上改造，输入中缺失 "category" 的第三条记录 {"key":"1234","fields":{"cityName":"Delhi","updated":"2023-04-31"}} 将被正确解析为 {"key":"1234","cityName":"Delhi","category":""}，全程无异常，输出严格符合预期格式。
