Map键值互换时因原Map多键对应同值导致Duplicate key异常，需用三参数toMap指定冲突策略，或groupingBy聚合；value须可作key且类型安全，BiMap仅适用于严格一一映射场景。
Map键值互换时，Collectors.toMap 报 IllegalStateException: Duplicate key
这是最常踩的坑：原Map里多个键对应同一个值，反转后这个值变成新键，就冲突了。Java默认不帮你合并，直接炸。
解决思路不是绕开报错，而是明确告诉它“重复键时怎么选”：
- 用三参数版
Collectors.toMap，第三个参数是(v1, v2) -> v1（保留第一个）或(v1, v2) -> v2（保留最后一个） - 如果想聚合（比如存成
List），得换思路：先groupingBy值，再对每个分组取键集合 - 注意原始Map的value类型必须能作新Map的key——得实现
equals和hashCode，否则看似互换成功，查不到
Map<String, Integer> original = Map.of("a", 1, "b", 1, "c", 2);
Map<Integer, String> swapped = original.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getValue,
Map.Entry::getKey,
(v1, v2) -> v1 // 明确处理重复key
));
手动遍历反转更可控，但别用 HashMap::put 直接覆盖
手写for循环看着踏实，但容易忽略value重复导致的静默覆盖——后put的键会把前面的顶掉，且无提示。
真正安全的手动方式是边遍历边检查：
立即学习“Java免费学习笔记（深入）”；
- 用
computeIfAbsent配合Set或List存多值，适合“一值多键”场景 - 若确定无重复value，用
putIfAbsent加一层校验，至少能发现异常数据 - 别在循环里反复新建Map实例，性能差；复用一个空Map即可
Map<Integer, Set<String>> multiSwap = new HashMap<>(); original.forEach((k, v) -> multiSwap.computeIfAbsent(v, k1 -> new HashSet<>()).add(k));
Guava的 BiMap 不是万能解，只适合严格一一映射
BiMap 的核心约束是“键唯一 + 值唯一”，插入重复value会抛 IllegalArgumentException，而不是帮你处理。
它适合配置项、状态码这类天然无歧义的映射，不适合用户数据等可能含重复值的场景：
- 创建时就得用
HashBiMap.create()，普通Map转不了 - 反转用
bimap.inverse()，返回的是视图，不是新Map，原Map改，它也跟着变 - 如果原始数据不确定是否满足双向唯一，先用
original.values().stream().distinct().count() == original.size()检查
泛型擦除会让 ClassCastException 在运行时才暴露
比如原Map是 Map<String, Object>，value里混了 Integer 和 String，反转时若声明新Map为 Map<Integer, String>，编译不报错，但遇到字符串value就崩。
关键点在于：类型检查只发生在插入时，而Stream操作延迟执行：
- 用
instanceof在map前过滤或转换value，别依赖泛型假象 - 如果value类型不确定，反转目标Map的value类型声明为
Object，后续再细分 - IDE和静态检查工具（如Error Prone）能抓这类问题，但得主动开开关
