Java中无真正只读集合,Collections.unmodifiableXXX()仅提供不可修改视图,底层仍可变;需防御性拷贝(如new ArrayList()后包装)或使用List.of()等不可变实现才能确保安全。

Java 里没有真正意义上的“只读集合”,Collections.unmodifiableXXX() 返回的只是**不可修改视图**,底层仍可变——这是最常被误解的一点。
为什么 Collections.unmodifiableList() 不能防住底层修改
它只是包装了原集合,所有写操作(如 add()、set())会抛 UnsupportedOperationException,但若原集合后续被其他引用修改,视图会同步反映变化。
常见错误场景:
- 把一个可变
ArrayList传给unmodifiableList(),再把原ArrayList保存在别处继续增删 - 多线程环境下,仅用
unmodifiableList()当线程安全集合用
Listmutable = new ArrayList<>(Arrays.asList("a", "b")); List readOnly = Collections.unmodifiableList(mutable); mutable.add("c"); // ✅ 合法!readOnly 现在包含 ["a", "b", "c"] readOnly.add("d"); // ❌ 抛 UnsupportedOperationException
Arrays.asList() 返回的列表本身就不支持增删
它返回的是 Arrays.ArrayList(非 java.util.ArrayList),是固定大小的内部类,add()/remove() 直接抛异常,但 set() 允许——所以它“半只读”,且仍指向原数组。
立即学习“Java免费学习笔记(深入)”;
注意点:
-
Arrays.asList(new String[]{"a","b"})返回的列表,修改元素会改原数组内容 - 如果原数组是
final,不代表列表就安全;只要有人拿到数组引用,就能改 - 它不支持
clear()、addAll()等结构性修改方法
String[] arr = {"x", "y"};
List list = Arrays.asList(arr);
list.set(0, "X"); // ✅ arr[0] 变成 "X"
arr[1] = "Y"; // ✅ list.get(1) 现在返回 "Y"
list.add("z"); // ❌ UnsupportedOperationException
想真正隔离数据?用 new ArrayList(source) + unmodifiable
要切断与原始数据的联系,必须做**防御性拷贝**。这是构建“事实只读集合”的关键一步。
适用场景:配置项、初始化参数、DTO 中的集合字段等需要确保外部无法影响内部状态的地方。
- 对
List:先new ArrayList(original),再Collections.unmodifiableList() - 对
Set/Map同理,分别用new HashSet()、new HashMap() - JDK 10+ 可直接用
List.copyOf()(要求源不可为null,且不接受null元素)
Listsource = new ArrayList<>(Arrays.asList("p", "q")); // ✅ 真正隔离 List trulyReadOnly = Collections.unmodifiableList( new ArrayList<>(source) ); source.add("r"); // 不影响 trulyReadOnly // ✅ JDK 10+ List copyOnly = List.copyOf(source); // 内部已不可变
Java 9+ 的 List.of() 和 Set.of() 是更优选择
它们创建的是紧凑、不可变、不可空的集合实现,比 unmodifiableXXX() 包装器更轻量、更安全,且明确禁止 null。
限制与注意:
- 元素数量上限:
List.of()最多 10 个参数(超限需用Arrays.asList().stream().collect(Collectors.toUnmodifiableList())) - 不接受
null:传入null会立即抛NullPointerException - 底层实现不是包装器,而是专用不可变类(如
ImmutableCollections.ListN),无反射绕过风险
Listsafe = List.of("a", "b", "c"); // ✅ 不可修改,不接受 null // safe.add("d"); // 编译不报错,但运行时抛 UnsupportedOperationException // List.of("x", null); // ❌ 直接 NPE
真正安全的只读集合,核心不在“加锁”或“包装”,而在“切断引用”和“拒绝可变构造”。哪怕用了 List.of(),如果它封装的是可变对象(比如 new Person("Alice")),那对象内部仍可变——只读永远只作用于集合结构层面。










