使用Collectors.toMap时需避免null key，推荐先filter过滤或用Optional/三元运算提供默认key，并在存在重复key时指定mergeFunction；还可封装为支持空值处理的泛型工具方法。

使用 Collectors.toMap 时若不处理 null key，会直接抛出 NullPointerException。关键不是“绕过”异常，而是提前过滤或转换，确保 key 非空。

过滤掉 key 为 null 的元素

最直接安全的做法：在流中先用 filter 剔除 key 计算结果为 null 的对象。

例如，将用户列表按姓名（name）映射为 Map，但部分用户 name 为 null：

List<User> users = Arrays.asList(
    new User("Alice", 25),
    new User(null, 30),
    new User("Bob", 28)
);

Map<String, Integer> nameToAge = users.stream()
    .filter(user -> user.getName() != null) // 关键：提前过滤
    .collect(Collectors.toMap(
        User::getName,
        User::getAge
    ));
// 结果：{"Alice"=25, "Bob"=28}

用 Optional 或三元运算提供默认 key

若业务允许用占位符代替 null key（如 "unknown"），可在 key mapper 中做转换：

• 用三元运算：

  user -> user.getName() != null ? user.getName() : "unknown"</li>
    <li>用 <code>Optional.ofNullable

  ：

  user -> Optional.ofNullable(user.getName()).orElse("unknown")</li>
  </ul>
  <p>注意：这不会丢弃数据，但需确认业务是否接受默认 key —— 否则可能引发覆盖（多个 null → 同一个 "unknown"）。</p>
  
  <H3>自定义 mergeFunction 防止重复 key 冲突</H3>
  <p>当多个对象生成相同 key（包括都转为 "unknown"）时，<code>toMap

  默认会报 IllegalStateException。此时需显式传入 merge 函数：

  Map<String, Integer> map = users.stream()
      .collect(Collectors.toMap(
          user -> Optional.ofNullable(user.getName()).orElse("unknown"),
          User::getAge,
          (oldVal, newVal) -> oldVal // 保留第一个值；也可取最大、求和等
      ));
  

  封装成可复用的工具方法

  避免每次手写 filter 或 orElse，可抽象为泛型工具方法：

  public static <T, K, U> Collector<T, ?, Map<K, U>> toMapSafe(
          Function<T, K> keyMapper,
          Function<T, U> valueMapper,
          K nullKeyFallback) {
      return Collectors.collectingAndThen(
          Collectors.toList(),
          list -> list.stream()
              .filter(item -> keyMapper.apply(item) != null)
              .collect(Collectors.toMap(keyMapper, valueMapper))
      );
  }
  // 使用：
  Map<String, Integer> m = users.stream().collect(toMapSafe(User::getName, User::getAge, null));
  

  更进一步可支持 fallback key + merge 策略，按需扩展。