Map.keySet()返回的Set是映射底层Map键结构的不可变视图，不支持add/addAll操作，因其无value定义和插入策略，强行调用会抛UnsupportedOperationException。
Map.keySet() 返回的 Set 是一个“视图”（view），不是独立集合，它直接映射底层 Map 的键结构，因此不允许添加新键——因为这等价于往 Map 里插入新映射关系，而 keySet() 本身不提供插入逻辑，只允许同步删除。
为什么 keySet() 返回的 Set 不支持 add/addAll
这个 Set 是由 Map 实现类内部构造的轻量级代理对象（比如 HashMap$KeySet），它不拥有数据副本，而是实时读取并反映 Map 当前的键集合。JDK 文档明确说明：该视图支持 remove、clear 等会同步影响 Map 的操作，但不支持 add 或 addAll——因为没有定义“新增键时对应的 value 应该是什么”，也没有约定插入策略（如哈希冲突处理）。强行添加会破坏 Map 结构一致性，所以直接抛出 UnsupportedOperationException。
常见触发场景
- 直接对 map.keySet() 赋值后的变量调用 add() 或 addAll()
- 将 map.keySet() 传给需要可变 Set 的方法，而该方法内部执行了 addAll()
- 误以为 keySet() 和 new HashSet(map.keySet()) 功能等价
- 在 Stream.collect(Collectors.toSet()) 后又试图 add，却混淆了不可变集合（如某些 Collectors 返回的 Set 实现）
如何快速排查是否踩了这个坑
遇到 UnsupportedOperationException 且堆栈指向 add() 或 addAll()，先检查目标 Set 的来源：
- 是否直接来自 map.keySet()、map.values() 或 map.entrySet()？这些视图均不可增
- 是否用了 Collections.unmodifiableSet() 包装过？也不可增
- 是否是 Arrays.asList().stream().collect(Collectors.toSet())？Java 10+ 的 toSet() 返回的是不可变 Set
- 打印 set.getClass() —— 如果是 HashMap$KeySet、LinkedHashMap$KeySet 或 UnmodifiableSet，就确认是受限视图
正确写法：需要可添加时，必须创建新集合
要合并多个 keySet 或追加额外键，必须显式新建一个可变 Set：
立即学习“Java免费学习笔记（深入）”；
错误写法：Set<String> keys = map1.keySet();
keys.addAll(map2.keySet()); // 报错
Set<String> keys = new HashSet<>(map1.keySet());
keys.addAll(map2.keySet()); // ✅
或者一步到位：
Set<String> keys = Stream.concat(map1.keySet().stream(), map2.keySet().stream())
.collect(Collectors.toCollection(HashSet::new));
