flatMap用于处理返回Optional的函数，自动解包避免嵌套；map适用于返回普通类型，而flatMap要求函数返回Optional并展平层级，确保结果始终为单层Optional。
Java 中 Optional 的 flatMap 方法专门用于处理“返回另一个 Optional”的函数，它会自动解包一层，避免产生 Optional<optional>></optional> 这种嵌套结构。
为什么需要 flatMap 而不是 map
map 适用于对值做转换后仍返回普通类型（如 String、Integer）的函数；但若函数本身返回的是 Optional，用 map 就会把结果再包一层 —— 比如 Optional<string></string> 经 map 调用一个返回 Optional<integer></integer> 的方法，得到的是 Optional<optional>></optional>，这既难读又不便后续操作。
flatMap 则要求传入的函数必须返回 Optional，它会直接“展平”这一层，最终仍是单层 Optional。
flatMap 的基本用法
假设有一个用户对象，其地址可能为空；地址中又有邮编，也可能为空：
class User { String name; Address address; }
class Address { String city; String zipCode; }
想安全获取邮编的 Optional<string></string>：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 错误写法（嵌套）：
userOpt.map(u -> getAddressOpt(u).map(a -> a.zipCode))→ 得到Optional<optional>></optional> - 正确写法（展平）：
userOpt.flatMap(u -> getAddressOpt(u)).flatMap(a -> Optional.ofNullable(a.zipCode))→ 得到Optional<string></string>
关键点：每个 flatMap 链式调用都接收一个 Function<t optional>></t>，并返回 Optional<r></r>，不叠加层级。
常见场景与实用技巧
实际开发中常用于链式查找、条件转换或外部服务调用：
- 查数据库返回
Optional，再根据结果查缓存也返回Optional→ 用flatMap串起来，保持扁平结构 - 解析 JSON 字段时，先取父字段（
Optional<jsonnode></jsonnode>），再取子字段（也返回Optional<string></string>）→ 必须用flatMap，否则类型不匹配 - 替代 if-else 判断：不用写
if (opt.isPresent()) { ... }，而是opt.flatMap(this::findRelated).filter(...).map(...)，语义更清晰
注意边界情况
flatMap 对空值有明确约定：
- 如果上游
Optional是空（empty()），则整个链提前终止，返回empty()，不会执行函数 - 如果函数内部返回
null，会抛NullPointerException—— 所以务必确保函数体返回的是合法Optional（推荐用Optional.ofNullable(...)包装可能为 null 的值） - 不能用
flatMap处理返回非Optional的函数；这种场景该用map
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
