collectors.tomap将list转map需明确键值提取及重复键处理策略，否则抛illegalstateexception或nullpointerexception；须确保键值非null、提供合并函数、必要时指定支持null的map工厂。

用 Collectors.toMap 将 List 转为 Map，核心是明确“键怎么取、值怎么取、重复键怎么办”。它不是万能转换器，用错会抛 IllegalStateException（重复 key）或 NullPointerException（key/value 为 null），实战中必须主动处理这三类问题。

指定 key 和 value 的提取方式

最基础用法是传入两个函数：一个提取 key，一个提取 value。要求每个元素都能稳定生成非 null 的 key 和 value。

• key 函数：通常用对象的唯一字段，比如 User::getId 或 item -> item.getCode()
• value 函数：可以是整个对象（Function.identity()），也可以是某个属性（User::getName）

示例：把用户列表按 ID 映射为 Map<long user></long>

List users = ...;
Map userMap = users.stream()
  .collect(Collectors.toMap(User::getId, Function.identity()));

处理 key 冲突：必须提供合并策略

当 list 中多个元素生成相同 key 时，不指定合并逻辑会直接抛异常。用第三个参数 BinaryOperator<v></v> 告诉它“同 key 时留哪个 value”。

• 保留第一个：(v1, v2) -> v1
• 保留最后一个：(v1, v2) -> v2（默认行为在 toMap 重载中不提供，必须显式写）
• 合并成新对象：比如计数场景，(sum, count) -> sum + count

示例：按部门统计人数，key 是 deptName，value 是人数，遇到同部门就累加

Map deptCount = users.stream()
  .collect(Collectors.toMap(
    User::getDeptName,
    u -> 1,
    (v1, v2) -> v1 + v2
  ));

允许 null key 或 value：需指定 map 工厂

toMap 默认使用 HashMap，不接受 null key/value。若源数据可能含 null，必须用四参数重载，传入支持 null 的 map 实现，比如 LinkedHashMap::new（支持 null value）或自定义 HashMap 子类（极少用）。

• 只允许 value 为 null：用 LinkedHashMap::new 即可
• 需要 key 也为 null：标准 Map 实现都不支持，建议提前 filter 掉或转成 Optional 包装

示例：允许用户名为空（value 为 null）

Map idToName = users.stream()
  .collect(Collectors.toMap(
    User::getId,
    User::getName,
    (v1, v2) -> v1,
    LinkedHashMap::new
  ));

常见错误与规避技巧

实际开发中最容易踩的坑，往往不是语法，而是语义理解偏差。

• 误以为 toMap 会自动去重：它不会跳过重复项，必须靠合并函数决定如何处理
• 忽略 null 安全：哪怕只有 1 个元素的 key 为 null，也会立即报 NPE；建议配合 Objects.requireNonNull 或提前 filter
• 用了无参 toMap 却没处理冲突：编译通过，运行时崩，务必检查业务是否真有唯一性保障
• value 提取返回 null 导致异常：比如 User::getName 返回 null，可在 value 函数里做空转默认值：u -> Optional.ofNullable(u.getName()).orElse("未知")