Collectors.toMap不支持自动剔除重复value，仅处理key冲突；value重复不影响映射，因Map允许不同key对应相同value；需前置过滤或反向映射实现value去重。
Collectors.toMap 本身不支持自动剔除重复 value，它只在 key 冲突时抛异常或允许自定义合并策略；value 重复与否完全不影响映射过程，也不会被自动过滤。
为什么 toMap 不处理 value 重复
toMap 的设计目标是将流中元素转换为 Map<k v></k>，核心约束在 key 的唯一性。Java 的 Map 接口允许不同 key 对应相同 value（例如 {"a": 1, "b": 1} 合法），因此 toMap 从不校验或去重 value。
如果你观察到“重复 value 被剔除”，实际可能是以下情况之一：
- 误把 key 重复当作 value 重复（例如对象的 equals/hashCode 实现导致 key 被视为相同）
- 后续用该 Map 构建了 Set 或 Stream.distinct() 等操作，混淆了处理阶段
- 使用了自定义收集器或额外过滤逻辑
若真需排除含重复 value 的条目，需手动过滤
可在收集前先对流做预处理：统计 value 出现次数，再保留 value 频次为 1 的元素。例如：
（以 Person.name → Person.id 映射为例，要求 id 不重复）```java
Map
.collect(Collectors.groupingBy(
p -> p.getId(), // 按 value 分组
Collectors.counting()
))
.entrySet().stream()
.filter(e -> e.getValue() == 1L) // 只保留出现一次的 value
.map(e -> list.stream().filter(p -> p.getId().equals(e.getKey())).findFirst().get())
.collect(Collectors.toMap(Person::getName, Person::getId));
```
更高效写法（单次遍历）：
```java
Map
.collect(Collectors.groupingBy(Person::getId, Collectors.counting()));
Map
.filter(p -> valueCount.getOrDefault(p.getId(), 0L) == 1)
.collect(Collectors.toMap(Person::getName, Person::getId));
```
替代方案：用 Map.entrySet() 后置去重
如果映射已生成，且你想基于 value 去重（保留第一个 key 对应的 entry），可用：
```java
Map
.collect(Collectors.toMap(Person::getName, Person::getId));
Map
.collect(Collectors.toMap(
Map.Entry::getKey,
Map.Entry::getValue,
(v1, v2) -> v1, // key 冲突时保留第一个 value（其实不会触发，因 key 已唯一）
() -> new LinkedHashMap()
));
// ⚠️ 注意：这仍不解决 value 重复问题
```
真正按 value 去重需反向索引：
```java
Map
.collect(Collectors.collectingAndThen(
Collectors.toMap(
Map.Entry::getValue, // value 作 key
Map.Entry::getKey, // key 作 value
(k1, k2) -> k1, // value 冲突时保留第一个 key
LinkedHashMap::new
),
map -> map.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getValue,
Map.Entry::getKey
))
));
```
总结关键点
- toMap 关注 key 唯一性，对 value 完全无感
- value 去重要么前置过滤（推荐），要么后置构建反向映射
- 避免在 toMap 的 mergeFunction 中试图操作 value 去重——它只解决 key 冲突
- 如业务强依赖“value 全局唯一”，建议在领域模型层校验，而非仅靠收集器
