Collectors.toMap()需传入键提取器、值提取器、冲突解决器三个函数，缺一不可；ID作键用obj->obj.getId()，值用Function.identity()，冲突解决器推荐(a,b)->a或抛异常；null ID易致NPE，应提前校验；并行场景需四参数版指定ConcurrentHashMap::new。
Collectors.toMap() 的三个参数怎么填
核心是传入三个函数：键提取器、值提取器、冲突解决器。ID 作键时，keyMapper 通常用 obj -> obj.getId()；值一般就是对象本身，用 Function.identity()；冲突解决器不能省——哪怕你确定 ID 唯一，也得显式提供，否则编译不通过。
常见错误是只传两个参数，比如 Collectors.toMap(obj -> obj.getId(), Function.identity())，这会报错：Cannot resolve method 'toMap(java.util.function.Function, java.util.function.Function)'。Java 8 的 toMap 重载里，两参数版本要求返回 Map 而非 ConcurrentMap，但默认实现不支持，必须补第三个参数。
- 推荐写法：
Collectors.toMap(obj -> obj.getId(), Function.identity(), (a, b) -> a) - 如果 ID 确实唯一且想快速失败，可用
(a, b) -> { throw new IllegalStateException("Duplicate key: " + a.getId()); } - 注意：
getId()返回类型要和 Map 的键类型一致（如Long或Integer），否则可能触发自动装箱/拆箱异常
遇到 NullPointerException 怎么排查
ID 字段为 null 是最常触发 NullPointerException 的原因——toMap 内部会尝试把 null 当作键插入 HashMap，而标准 HashMap 不允许 null 键（除非显式用 ConcurrentHashMap，但 toMap 默认不用）。
- 检查源列表：先执行
list.stream().filter(Objects::isNull).count()看是否有空对象 - 再查 ID：用
list.stream().filter(obj -> obj.getId() == null).count() - 安全写法：在键提取器中防御，例如
obj -> Optional.ofNullable(obj).map(Entity::getId).orElseThrow(() -> new IllegalArgumentException("Null object or null ID"))
想用 ConcurrentHashMap 怎么办
默认 toMap 返回的是普通 HashMap 实例，不支持并发写入。如果流是并行的（parallelStream()），或后续要在多线程环境修改这个 Map，就得指定 Map 工厂。
- 用四参数版本：
Collectors.toMap(obj -> obj.getId(), Function.identity(), (a, b) -> a, ConcurrentHashMap::new) - 注意：四参数版的冲突解决器仍不可省，且工厂函数必须返回具体 Map 类型（
ConcurrentHashMap::new可，Map::new不可） - 性能提示：并发容器有额外开销，单线程场景没必要换
替代方案：用 groupingBy 配合 collectingAndThen
当你要的不是“ID → 对象”，而是“ID → 某个字段”，或者需要做进一步转换（比如只取 name 字段），直接用 toMap 就得手动写值提取器；这时 groupingBy + collectingAndThen 更清晰。
例如转成 Map<long string></long>（ID → name）：
Map<Long, String> idToName = list.stream()
.collect(Collectors.groupingBy(
Entity::getId,
Collectors.collectingAndThen(
Collectors.mapping(Entity::getName, Collectors.toList()),
names -> names.isEmpty() ? null : names.get(0)
)
));
不过这种写法比 toMap 多一层包装，纯 ID→对象映射时没必要绕路。
真正容易被忽略的是：ID 类型和泛型擦除的交互——比如 List<? extends BaseEntity> 流，若 BaseEntity 的 getId() 返回 Serializable，编译器可能推断不出键类型，导致后续 get 时需要强转。这时候显式声明类型参数或提前 cast 更稳妥。
