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免费学习笔记（深入）”；
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 如果你通过原始 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时，务必这样做，避免暴露可变状态。
