使用Collectors.toMap转换泛型集合为复杂Map，需确保键唯一并指定冲突策略，避免null键值，合理设计valueMapper处理嵌套结构，并显式声明泛型类型保障类型安全。
用 Collectors.toMap 将泛型集合转为复杂 Map，关键不在“多写几行”，而在选对键值逻辑、处理好冲突与空值、明确类型边界。Java 8 的 Stream API 提供了简洁入口，但稍不注意就会抛 NullPointerException 或 IllegalStateException。
确保键唯一，否则显式定义冲突策略
默认的 toMap(keyMapper, valueMapper) 要求键不能重复，否则运行时报 IllegalStateException: Duplicate key。若源数据天然可能含重复键（比如按用户状态分组但多个用户同状态），必须提供第三个参数——合并函数：
-
(v1, v2) -> v1：保留第一个值 -
(v1, v2) -> v2：保留最后一个值 -
(v1, v2) -> merge(v1, v2)：自定义合并逻辑，例如拼接字符串、累加数值、构建列表等
例如将 List<User> 按部门 ID 映射为 Map<Long, String>（部门名），但多个用户可能属同一部门，需去重取首个部门名：
避免 null 键或 null 值引发崩溃
toMap 默认不接受 null 键或值（HashMap 不允许 null 键，而 Collectors 实现内部会直接调用 map.put(key, value)）。若映射函数可能返回 null（如 User::getName 返回 null），需提前过滤或替换：
- 过滤掉 null 键：
.filter(u -> u.getId() != null) - 兜底默认值：
u -> Optional.ofNullable(u.getName()).orElse("unknown") - 用
Collectors.toConcurrentMap（支持 null 值，但依然不支持 null 键）
组装嵌套结构或复合值时，优先用 toMap + 自定义 valueMapper
所谓“复杂 Map”，常指值不是简单类型，而是对象、集合或另一层 Map。这时不要强行塞进单个 toMap，而是把 valueMapper 写成构造逻辑：
- 转为
Map<String, List<User>>：用Collectors.groupingBy更自然；但若坚持用 toMap，valueMapper 可返回users.stream().filter(...).collect(Collectors.toList()) - 转为
Map<Long, Map<String, Object>>：valueMapper 中 new HashMap(), put 多个字段 - 需要统计+聚合（如某类订单的总金额、笔数）：valueMapper 返回自定义 DTO 或 record，例如
new OrderSummary(count, sum)
示例：按城市分组，每个城市对应一个包含用户数和平均年龄的 Map：
users.stream().collect(toMap(
User::getCity,
u -> Map.of("count", 1, "avgAge", (double) u.getAge()),
(m1, m2) -> Map.of(
"count", (int)m1.get("count") + (int)m2.get("count"),
"avgAge", ((double)m1.get("avgAge") + (double)m2.get("avgAge")) / 2
)
));
泛型擦除下保持类型安全：显式声明类型参数
当 value 是泛型类（如 Map<String, List<String>>）时，lambda 中容易因类型推断失败导致编译错误。此时可显式写出泛型类型：
- 用方法引用替代 lambda（更易推断）：
User::getTags比u -> u.getTags()更稳 - 必要时强转或拆分：先 collect 到中间容器，再 map 转换
- 在 IDE 中观察 infer 类型提示，或临时加
(Map<String, List<String>>)Collections.emptyMap()辅助推断
不复杂但容易忽略。
