Collections.unmodifiableList用于创建只读列表,防止外部修改。它封装原列表并抛出UnsupportedOperationException阻止增删改操作,但不阻止通过原始引用修改列表,因此需先复制再封装以确保安全。

在Java中,Collections.unmodifiableList 是一个静态方法,用于将已有列表包装成不可修改的视图。调用该方法后返回的列表不允许执行添加、删除、更新等操作,一旦尝试修改就会抛出 UnsupportedOperationException 异常。这种方法常用于保护内部数据不被外部随意更改,提升程序安全性。
使用 Collections.unmodifiableList 的基本方法
要创建一个只读列表,可以调用 Collections.unmodifiableList(list),传入一个已存在的 List 对象。返回的对象是原列表的只读视图,所有读取操作(如 get、size)仍可正常进行。
示例代码:
ListoriginalList = new ArrayList<>(); originalList.add("A"); originalList.add("B"); List readOnlyList = Collections.unmodifiableList(originalList); System.out.println(readOnlyList.get(0)); // 输出 A readOnlyList.add("C"); // 抛出 UnsupportedOperationException
只读集合的注意事项
虽然返回的列表是不可修改的,但原始列表如果还能被访问,依然可以被修改。这意味着只读视图并不是完全独立的副本。
立即学习“Java免费学习笔记(深入)”;
- 只读列表是对原列表的封装,不是深拷贝
- 若原始列表后续被修改,只读列表也会反映这些变化
- 要实现真正安全的只读,建议先复制再封装
更安全的做法:
ListsafeReadOnly = Collections.unmodifiableList( new ArrayList<>(originalList) );
这样即使 originalList 后续被修改,safeReadOnly 也不会受影响。
防止修改的核心机制说明
unmodifiableList 返回的是 UnmodifiableRandomAccessList 或 UnmodifiableList 类型的对象,这些类重写了所有可能修改集合的方法(如 add、set、remove、clear 等),并在方法体内直接抛出异常。
- 仅提供对原列表的“只读访问”通道
- 不阻止通过其他引用修改原列表
- 适用于需要共享数据但禁止修改的场景,如配置项、工具类返回值等
基本上就这些。使用 Collections.unmodifiableList 能有效防止对列表的意外修改,但要注意源头控制和对象复制,才能确保真正的不可变性。










