当使用 jackson 的 `jsonnode` 链式调用 `optional.map()` 时，若中间节点为 `nullnode`（非 java `null`，而是 json `null`），直接调用 `.textvalue()` 会触发 `nullpointerexception`；正确做法是将操作拆分为多步 `map`，利用 `optional` 对 `null` 的自动短路机制安全提取值。

在处理 JSON 数据流时，Optional 常用于封装可能为空的解析结果。但需特别注意：Jackson 的 NullNode 是一个合法的 JsonNode 子类实例（即 customerInfo.get("name") 可能返回 NullNode 而非 Java null），而 NullNode.textValue() 返回 null —— 这本身不抛异常；真正引发 NullPointerException 的是后续对 null 的链式调用（例如 null.textValue()），或更常见的情况：误判 NullNode 为“存在但值为 null”，导致 Optional.of(null) 被创建，破坏了 Optional 的语义完整性。

关键误区在于：Optional.map() 在函数返回 null 时，不会返回 Optional.empty()，而是返回 Optional.ofNullable(null) → 即 Optional.empty() ✅——但前提是该 null 是 Java null。而 JsonNode.get(key) 在 key 不存在或值为 JSON null 时，均返回 NullNode 实例（非 null），因此 map(data -> data.get("customerInfo")) 仍会返回 Optional，而非 Optional.empty()。此时若继续 .map(n -> n.textValue())，虽不会 NPE（因 NullNode.textValue() 安全返回 null），但若后续逻辑依赖非空字符串，则需显式过滤。

✅ 正确且健壮的写法如下（分步 + 空值防护）：

Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

下载

Optional<String> customerName = getOrderData()
    .map(data -> data.get("customerInfo"))           // Optional<JsonNode> (may be NullNode)
    .filter(Objects::nonNull)                        // Exclude if customerInfo is missing (null)
    .filter(node -> !node.isNull())                  // Exclude if customerInfo is JSON null (NullNode)
    .map(customerInfo -> customerInfo.get(name))     // Optional<JsonNode> for the field
    .filter(Objects::nonNull)
    .filter(field -> !field.isNull())
    .map(JsonNode::textValue);                       // Optional<String>

⚠️ 注意事项：

• JsonNode.isNull() 是判断是否为 NullNode 的标准方式，不可用 == null；
• filter(Objects::nonNull) 用于排除 JsonNode 本身为 null（即字段不存在）；
• 若业务允许 null 字符串语义，可省略部分 filter，但推荐显式区分“缺失”与“JSON null”；
• Optional.map() 本身不会将 NullNode 转为 Optional.empty()，必须主动检查。

总结：Optional 的安全性依赖于你是否在每一步都正确识别并过滤掉无效节点。将单次 map 拆解为多步 map + filter 组合，不仅能避免 NPE，还能清晰表达数据契约，提升代码可维护性与鲁棒性。