必须用flatmap当某步方法返回optional，否则会嵌套成optional；map用于返回普通对象，flatmap自动拆壳保持扁平，混合使用时需严格匹配返回类型。

Java 中用 flatMap 做链式空值处理，核心是让每一步“可能返回 Optional”的操作自然衔接，避免嵌套、跳过空值、不抛 NPE。

什么时候必须用 flatMap？

当某一步方法的返回类型本身就是 Optional（比如 User::getAddressOptional() 或数据库查询返回 Optional<order></order>），就不能用 map ——否则会得到 Optional<optional>></optional>，造成嵌套。

• map：适合返回普通对象（String、Integer、Address 等）
• flatMap：适合返回 Optional<t></t>，它会自动“拆一层壳”，保持链条扁平

基础链式写法模板

从源头开始，每一步按实际返回类型选 map 或 flatMap：

String city = Optional.ofNullable(user)
    .flatMap(User::getAddressOptional)  // 返回 Optional<address>
    .flatMap(Address::getCityOptional)  // 返回 Optional<string>
    .orElse("未知城市");
</string>
</address>

只要中间任意一步是 Optional.empty()，后续函数不会执行，最终结果就是 empty()，orElse 再兜底。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

混合使用 map 和 flatMap 的常见场景

现实逻辑常是“部分方法返回普通对象，部分返回 Optional”：

• 用户对象非 null → getProfile() 返回普通 Profile → 用 map
• Profile.getSettings() 返回 Optional<settings></settings> → 用 flatMap
• Settings.getTimeout() 返回 Integer → 用 map

完整链路：

Integer timeout = Optional.ofNullable(userId)
    .flatMap(this::findUserById)          // 返回 Optional<user>
    .map(User::getProfile)                // 返回 Profile（非 Optional）
    .flatMap(Profile::getSettings)        // 返回 Optional<settings>
    .map(Settings::getTimeout)            // 返回 Integer
    .orElse(30);
</settings></user>

注意边界情况和易错点

flatMap 不是万能的，用错会编译失败或逻辑异常：

• 如果方法返回 null（不是 Optional），必须先包装：flatMap(u -> Optional.ofNullable(u.getAddress()))
• 不要对 Optional.empty() 调用 get()，应始终用 orElse、orElseGet 或 ifPresent
• of() 不能传 null，一律优先用 ofNullable()

链式越长，越要确认每一步的返回类型——这是写对 flatMap 的前提。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南