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 的基本用法
假设有一个用户对象，其地址可能为空；地址中又有邮编，也可能为空：
立即学习“Java免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
class User { String name; Address address; }
class Address { String city; String zipCode; }
想安全获取邮编的 Optional<string></string>：
- 错误写法（嵌套）：
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
不复杂但容易忽略。
