partitioningBy 是仅按布尔条件将流分为 true/false 两组的专用收集器，而 groupingBy 可按任意函数生成多组；前者性能更优但灵活性低，后者通用但无短路优化。
partitioningBy 是什么，和 groupingBy 有什么根本区别
Collectors.partitioningBy 不是分组工具的“简化版”，它只接受一个 Predicate（返回 boolean 的函数），强制把流分成且仅分成两组：true 和 false。而 groupingBy 接收的是 Function，能产出任意类型、任意数量的 key —— 比如按字符串首字母、按枚举值、按计算出的区间。
这意味着：如果你需要三分、五分、或 key 不是布尔值，partitioningBy 直接不适用，硬套会编译报错或逻辑错乱。
-
partitioningBy返回Map<boolean list>></boolean>，key 只有true/false两个固定值 -
groupingBy(x -> x > 5)看似像 partitioningBy，但实际返回的是Map<boolean list>></boolean>—— 这是groupingBy的一种特例用法，不是partitioningBy，且无法享受后者提供的下游收集器优化 - 性能上，
partitioningBy内部做了短路判断优化，对布尔判定场景更轻量
怎么写一个安全可靠的 partitioningBy 调用
最常见错误是传入 null 的 Predicate，导致运行时抛 NullPointerException；其次是误以为能传多个条件，试图写成 partitioningBy(x -> x != null && x.length() > 3) —— 这没问题，但它是单个布尔表达式，不是“多条件组合”的特殊语法。
- 必须确保
Predicate对流中每个元素都能安全求值（比如避免对 null 调用方法） - 如果原始数据可能为 null，先用
filter(Objects::nonNull)或在 predicate 里显式判空：partitioningBy(Objects::nonNull) - 下游可接第二个收集器，例如
partitioningBy(isEven, Collectors.counting())→ 得到Map<boolean long></boolean> - 不要试图用
partitioningBy替代过滤操作；它始终返回完整两组，哪怕某组为空（false组可能是空 list）
示例：
List<String> words = Arrays.asList("a", "bb", "ccc", "");
Map<Boolean, List<String>> byLength = words.stream()
.collect(Collectors.partitioningBy(s -> s.length() > 1));结果：{false=[a, ""], true=[bb, ccc]}
下游收集器用错会导致什么现象
传错下游收集器不会编译失败，但结果类型会意外变化，且容易引发 ClassCastException 或空指针 —— 尤其当下游用了 Collectors.toSet() 却又按 List 强转时。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 默认下游是
toList()，所以不传第二个参数时，value 类型固定为List<t></t> - 若传了
Collectors.counting()，value 类型变成Long，此时再访问map.get(true).size()会编译报错 - 若传了
Collectors.mapping(..., toList())，要注意映射函数本身不能返回 null，否则mapping会跳过该元素（静默丢弃），不是你想要的“分区”语义 - 别用
Collectors.collectingAndThen包裹下游来“转换类型”，它不改变 key 结构，但会让 value 类型更难推断，增加维护成本
为什么有时候 partitioningBy 返回的 false 组里有 null 元素
这不是 partitioningBy 的 bug，而是你传入的 Predicate 本身对 null 返回了 true 或 false —— 它完全尊重你的逻辑。Java 中 Objects.isNull(null) 是 true，String::isEmpty 在 null 上会抛 NullPointerException，而 s -> s != null && s.isEmpty() 才安全。
- null 元素不会被自动过滤或特殊处理，它和其他元素一样参与 predicate 判定
- 如果希望 null 单独成一类，
partitioningBy无能为力 —— 它只有两个桶，null 必须归入true或false其中之一 - 真正需要“三类分流”（如 null / true / false），得用
groupingBy配合自定义 key 枚举或字符串标记
边界情况永远藏在 predicate 里，不在 collector 里。写之前，先想清楚 null、空字符串、数值边界值会怎么走分支。
