Stream.flatMap 用于将嵌套结构扁平化为单层流，配合 map 实现空值安全、层级跳转与类型收敛；适用于 Optional、List、自定义包装类等多级代理场景，提升代码声明性与健壮性。
Stream.flatMap 可以把嵌套结构“拍平”成一层流，特别适合从多级代理（比如 Optional<Optional<T>>、List<List<T>>、Optional<List<T>> 等）中提取最终的目标对象。关键不是“扁平化”动作本身，而是用好 map + flatMap 的组合逻辑，让空值安全、层级跳转、类型收敛自然发生。
处理多层 Optional：避免 isPresent() 嵌套
当对象链形如 User → Optional<Profile> → Optional<Address> → String city，直接调用 .get() 容易抛出 NoSuchElementException，而层层 isPresent 判断又冗长。flatMap 能把 Optional 当作“可为空的容器”，天然支持短路：
String city = Optional.ofNullable(user)
.flatMap(u -> u.getProfile()) // 返回 Optional<Profile>
.flatMap(p -> p.getAddress()) // 返回 Optional<Address>
.map(a -> a.getCity()) // 返回 Optional<String>
.orElse("未知城市");
说明：
• 每次 flatMap 接收一个 Optional<X>，返回另一个 Optional<Y>，若上游为 empty，则整个链自动终止；
• map 用于最后一步非 Optional 类型转换（如 String）；
• 不要用 get() 或 orElseThrow() 中途打断链式。
展开 List<List<T>> 或 List<Optional<T>>
常见于查询结果聚合：比如每个订单有多个子订单，每个子订单可能关联一个优惠券（Optional），要汇总所有实际使用的优惠券 ID：
List<String> couponIds = orders.stream()
.flatMap(order -> order.getSubOrders().stream()) // List<SubOrder> → Stream<SubOrder>
.flatMap(sub -> sub.getCoupon().stream()) // Optional<Coupon> → Stream<Coupon>
.map(Coupon::getId) // Stream<Coupon> → Stream<String>
.collect(Collectors.toList());
说明：
• optional.stream() 是关键技巧：empty Optional 生成空 Stream，非空则生成含 1 个元素的 Stream；
• 第一个 flatMap 把“订单列表”摊成“子订单流”，第二个 flatMap 把“每个子订单的优惠券 Optional”摊成“零或一个优惠券的流”；
• 整体效果等价于双重 for 循环 + if (coupon != null)，但更声明式、无副作用。
混合嵌套场景：List<Optional<List<T>>>
例如 API 返回一批用户数据，每个用户的标签列表字段是 Optional<List<Tag>>，需提取全部非空标签：
List<Tag> allTags = users.stream()
.flatMap(user -> user.getTags().orElse(Collections.emptyList()).stream())
.collect(Collectors.toList());
或者更安全地结合 flatMap 处理 Optional：
List<Tag> allTags = users.stream()
.flatMap(user -> user.getTags().stream()) // Optional<List<Tag>> → Stream<List<Tag>>
.flatMap(list -> list.stream()) // List<Tag> → Stream<Tag>
.collect(Collectors.toList());
说明：
• 第一个 flatMap 把 Optional 展开为 0 或 1 个 List；
• 第二个 flatMap 把每个 List 再展开为元素流；
• 这种写法完全规避了 null 和空集合判空，也无需提前 .orElse(...) 构造默认集合。
自定义代理类型（如 Result<T>、Response<T>）的适配
如果项目中用了封装类如 Result<User> 或 ApiResponse<Profile>，只要它提供类似 flatMap(Function<T, Result<R>>) 或 stream() 方法，就能接入 Stream 流程。推荐统一添加 stream() 辅助方法：
public class Result<T> {
private final T data;
private final boolean success;
public Stream<T> stream() {
return success && data != null ? Stream.of(data) : Stream.empty();
}
}
之后即可：
List<String> names = results.stream()
.flatMap(Result::stream) // Result<User> → Stream<User>
.map(User::getName)
.collect(Collectors.toList());
说明：
• 不强求代理类实现 Optional 风格 API，只需能转成 Stream；
• 所有自定义包装类型都可以通过 stream() 方法“接入”函数式链条，保持风格统一；
• 避免在流中混用 try-catch 或 if-else 分支判断成功/失败状态。
核心就三点：把每层代理看作“可展开的容器”，用 flatMap 表达“从这层取下一层”的依赖关系，用 map 完成最终值提取。只要容器支持转 Stream（或提供 flatMap），多深的嵌套都能线性表达，既安全又简洁。
