flatMap 是处理嵌套 Optional 的核心方法，它能自动“拆箱”合并，避免嵌套的 Optional；而 map 会将函数返回的 Optional 作为值包裹，导致类型加深，无法直接获取最内层值。

flatMap 是处理嵌套 Optional 的核心方法，它能把 Optional<optional>></optional> 一层层“压平”，避免手动判空和层层 get。

为什么不能用 map？

map 会把函数返回的 Optional<t></t> 当作普通值包进外层 Optional，结果变成 Optional<optional>></optional>；而 flatMap 要求函数直接返回 Optional<t></t>，它会自动“拆箱”合并，只保留最内层的值或空状态。

基本用法：展开单层嵌套

比如有一个用户对象，其地址是 Optional<address></address>，而地址里的城市又是 Optional<string></string>：

Optional<User> userOpt = Optional.of(new User());
Optional<Optional<String>> cityOptOpt = userOpt.map(u -> u.getAddress().map(a -> a.getCity()));
// ❌ 得到的是 Optional<Optional<String>>，还要再 get() 一次，容易 NPE

Optional<String> cityOpt = userOpt.flatMap(u -> u.getAddress()).flatMap(a -> a.getCity());
// ✅ 直接得到 Optional<String>，全程安全

链式调用中自然处理空值

flatMap 遇到任意一环是 Optional.empty()，整条链立刻短路返回 empty()，不用写 if 判空：

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

立即学习“Java免费学习笔记（深入）”；

• 如果 userOpt 为空 → 整个表达式返回 empty()
• 如果 userOpt 有值但 getAddress() 返回 empty() → 后续 flatMap 不执行，仍返回 empty()
• 只有每一步都非空，最终才得到城市名的 Optional<string></string>

配合工厂方法或查找逻辑使用

常见场景是根据 ID 查找对象，而查找方法本身返回 Optional：

Optional<String> userId = getUserID(); // 可能为空
Optional<User> user = userId.flatMap(id -> userRepository.findById(id)); // ✅ 干净安全
Optional<String> userName = user.flatMap(u -> u.getName()); // 继续展开

这比先 if (userId.isPresent()) 再查库、再判空，更简洁且不可变。