当使用 jackson 的 jsonnode 链式调用 `optional.map()` 提取嵌套字段时，若中间节点为 `nullnode` 或 `null`，直接调用 `.textvalue()` 会触发 npe；正确做法是将每层访问拆分为独立的 `map` 调用，使 `null` 自动转为 `optional.empty()`。
在 Java 中，Optional.map() 的设计契约是：若当前 Optional 为空（empty），则跳过函数执行，直接返回 empty；但若当前 Optional 非空，而映射函数返回 null，则 map 会将其包装为 Optional.ofNullable(null)，即 Optional.empty() —— 这正是我们期望的行为。
然而，问题代码中的关键陷阱在于：
orderData.map(data -> data.get("customerInfo"))
.map(customerInfo -> customerInfo.get(name).textValue());此处 customerInfo.get(name) 可能返回 null（例如字段不存在）或 Jackson 的 NullNode（JSON 中显式 "name": null）。而 NullNode.textValue() 返回 null，但 null.textValue() 并不成立 —— 实际上，NullNode 是 JsonNode 子类，其 textValue() 安全返回 null；真正引发 NPE 的是：当 customerInfo.get(name) 返回 null（即 Java null，非 NullNode）时，.textValue() 调用发生在 null 引用上。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
✅ 正确解法是分层解构：将每个可能为 null 的节点访问单独置于一次 map 中，利用 Optional.map(f) 对 f 返回 null 时自动转为 Optional.empty() 的特性：
Optional<String> result = getOrderData()
.map(data -> data.get("customerInfo")) // returns Optional<JsonNode> (empty if data is null or "customerInfo" missing)
.map(customerInfo -> customerInfo.get(name)) // returns Optional<JsonNode> (empty if customerInfo is null or name field absent/null)
.map(node -> node.textValue()); // returns Optional<String> (empty if node is null)⚠️ 注意事项：
- Jackson 的 NullNode 是有效 JsonNode 实例，NullNode.textValue() 返回 null，不会 NPE；真正危险的是 Java null 引用。
- 确保 getOrderData() 返回的是 Optional
（而非 Optional.ofNullable(JsonNode) 包裹了 null），否则初始 Optional 就为空。 - 若需区分 JSON null 与字段缺失，可结合 has() 或 isMissingNode() 判断，但本方案统一按“不可用”处理，语义清晰且安全。
总结：不要在一个 map 中执行多级导航 + 方法调用；每一层 get(...) 都应作为独立 map 步骤，让 Optional 的空值传播机制自然生效 —— 这既是函数式风格的最佳实践，也是避免 NPE 的最简洁防御策略。
