Collectors.toMap不支持多字段复合Key，需通过字符串拼接（如"dept|role"）或自定义不可变Key类（如record DeptRoleKey）实现；必须提供merge函数避免重复key异常。
用 Collectors.toMap 直接支持多字段复合 Key 是做不到的，因为它的 keyMapper 参数只接受单个函数，返回一个 Object 类型的 key。但你可以通过“构造唯一字符串”或“自定义不可变 Key 类”两种主流方式，把多个字段组合成一个合法的 Map Key。
用字符串拼接生成复合 Key（简单场景首选）
适合字段值本身不含分隔符（如逗号、下划线）、且不追求类型安全的快速实现。
- 将多个字段用固定分隔符（如
"|"或"_"）拼成字符串作为 key - 确保字段顺序固定、null 值提前处理，避免
null|name和id|null冲突 - 示例：按
department+role分组取最新员工
Map<String, Employee> map = employees.stream()
.collect(Collectors.toMap(
e -> e.getDepartment() + "|" + e.getRole(), // 复合 key
Function.identity(),
(e1, e2) -> e1.getUpdateTime().isAfter(e2.getUpdateTime()) ? e1 : e2 // 取新
));
定义静态内部类作为 Key（推荐用于生产环境）
更健壮、可读性高、支持 null 安全、IDE 可提示、序列化友好。
- Key 类必须重写
equals()和hashCode()（用 Lombok@EqualsAndHashCode最省事） - 字段设为 final，构造时校验非空（可选），保证不可变性
- 建议加
toString()方便调试
record DeptRoleKey(String department, String role) {
public DeptRoleKey {
Objects.requireNonNull(department, "department cannot be null");
Objects.requireNonNull(role, "role cannot be null");
}
}
映射使用：
Map<DeptRoleKey, Employee> map = employees.stream()
.collect(Collectors.toMap(
e -> new DeptRoleKey(e.getDepartment(), e.getRole()),
Function.identity(),
(e1, e2) -> e1.getSalary() > e2.getSalary() ? e1 : e2
));
用 Map.Entry 或 AbstractMap.SimpleImmutableEntry 临时凑合
不推荐长期使用，但适合一次性脚本或原型验证——无需额外类，利用 JDK 已有类型。
-
AbstractMap.SimpleImmutableEntry是不可变的，自带正确equals/hashCode - 注意：key 是
Entry<k></k>，语义不如自定义类清晰 - 不能直接用
Map.entry(k1,k2)（那是Map.Entry<k></k>，泛型限制只能两个字段且类型需一致）
Map<AbstractMap.SimpleImmutableEntry<String, String>, Employee> map = employees.stream()
.collect(Collectors.toMap(
e -> new AbstractMap.SimpleImmutableEntry<>(e.getDepartment(), e.getRole()),
Function.identity(),
(e1, e2) -> e1
));
避坑提醒：toMap 的三个参数一个都不能少
当存在重复 key 时，toMap(keyMapper, valueMapper) 会抛 IllegalStateException。必须显式提供 merge 函数。
- 合并策略要明确：保留第一个？取最大值？合并对象字段？
- 如果真想“遇到重复就报错”，可用
throwingMerger()封装异常逻辑 - valueMapper 不一定是
Function.identity()，也可以是转换后的值，比如e -> e.getName()
private static <T> BinaryOperator<T> throwingMerger() {
return (u,v) -> { throw new IllegalStateException("Duplicate key: " + u); };
}
不复杂但容易忽略：复合 Key 的本质是把多个维度“扁平化”成一个可哈希对象。选字符串还是自定义类，取决于你对可维护性、性能和类型的权衡。
