Collections.unmodifiableMap返回只读视图,禁止修改操作并抛出异常;它包装原Map但非深拷贝,原始Map变更仍影响视图;为实现真正不可变,应先创建副本再封装,如Collections.unmodifiableMap(new HashMap<>(original)),防止外部修改。

在Java中,Collections.unmodifiableMap 是一种创建只读映射(不可修改的Map)的标准方式。它返回一个包装原Map的视图,任何试图修改该视图的操作都会抛出 UnsupportedOperationException 异常,从而保护原始数据不被更改。
基本用法:创建只读映射
使用 Collections.unmodifiableMap 非常简单。你只需要传入一个已有的Map实例,方法会返回一个不可修改的视图。
示例代码:
Map<String, Integer> originalMap = new HashMap<>();
originalMap.put("Alice", 25);
originalMap.put("Bob", 30);
// 创建只读映射
Map<String, Integer> readOnlyMap = Collections.unmodifiableMap(originalMap);
// 下面的操作将抛出异常
readOnlyMap.put("Charlie", 35); // ❌ 抛出 UnsupportedOperationException
只读映射的保护机制解析
需要注意的是,unmodifiableMap 返回的是原Map的一个封装视图,并不是深拷贝。这意味着:
立即学习“Java免费学习笔记(深入)”;
- 如果你通过原始 map 修改内容,只读视图中的数据也会改变
- 但不能通过只读视图反向修改,否则会触发异常
例如:
Map<String, Integer> data = new HashMap<>();
data.put("x", 100);
Map<String, Integer> safeView = Collections.unmodifiableMap(data);
data.put("y", 200); // ✅ 允许,原始map被修改
System.out.println(safeView.get("y")); // 输出 200,视图同步更新
safeView.clear(); // ❌ 抛出异常,禁止修改
如何实现真正的只读?
为了确保映射完全不可变,建议在创建只读视图前先进行**防御性拷贝**,避免外部对原始引用的操控。
推荐做法:
Map<String, String> config = new HashMap<>();
config.put("host", "localhost");
config.put("port", "8080");
// 安全的只读映射:先复制,再封装
Map<String, String> immutableConfig = Collections.unmodifiableMap(
new HashMap<>(config) // 构造副本
);
// 此时即使 config 后续被修改,immutableConfig 也不受影响
这种方式能有效防止后续对原始map的操作影响只读视图,是实际开发中更安全的选择。
基本上就这些。Collections.unmodifiableMap 不复杂但容易忽略细节,关键是理解它只是“视图保护”,真正安全需要配合拷贝使用。尤其在API返回内部map时,务必这样做,避免暴露可变状态。










