详解UnsupportedOperationException_为什么不可变集合会抛出此异常

陆砚码

2026-10-30 • 👁 0人浏览过

List.of() 返回不可变列表，调用 add() 等修改方法直接抛 UnsupportedOperationException；Arrays.asList() 返回的也是不可变视图，仅支持 set() 和 get()，不支持增删；安全转可变需新建 ArrayList。为什么

List.of()

一调

add()

就崩？因为

List.of()

返回的压根不是普通

ArrayList

，而是一个 JDK 内部实现的不可变列表类（比如

ImmutableCollections.ListN

），它的

add()

、

remove()

、

clear()

等所有修改方法，都直接抛出

UnsupportedOperationException

—— 这不是 bug，是设计如此。它不持有可变底层数组，也不做任何状态维护，只保证“创建后绝对不变” 哪怕只传一个元素，

List.of("a")

也和

Arrays.asList("a")

行为不同：后者还能

set()

，前者连

set()

都不支持它不接受

null

，传进去立刻抛

NullPointerException

，不会等到修改时才报错

Arrays.asList()

看似能改，其实很危险

Arrays.asList()

返回的也不是

java.util.ArrayList

，而是

Arrays

的静态内部类

ArrayList

（注意包名不同），它继承自

AbstractList

，而

AbstractList.add()

默认就 throw

UnsupportedOperationException

。它支持

set()

和

get()

，因为底层直接映射原数组 —— 所以

list.set(0, "X")

会真的改掉原数组但它不支持

add()

、

remove()

、

addAll()

，因为数组长度固定，没法扩容或缩容常见翻车场景：

Arrays.asList(arr).removeIf(...)

或

.removeAll(...)

，全都会炸怎么安全地把不可变集合转成可改的？核心原则：别试图“解锁”不可变对象，而是用它作为数据源，新建一个可变容器。最通用写法：

new ArrayList(List.of("a", "b"))

或

new ArrayList(Arrays.asList("a", "b"))

如果只是临时增删，且确定后续不再需要原不可变结构，可以直接构造：

ArrayList list = new ArrayList(List.of("x", "y"));

别用

Collections.unmodifiableList(new ArrayList())

来“假装不可变”再回头改 —— 这属于自己绕晕自己，该用可变就用可变注意性能：小集合（List.of() 初始化再转

ArrayList

开销极小；大数据量别无脑套，先评估是否真需要中间不可变层还有哪些地方会静默埋雷？除了显眼的

List.of()

和

Arrays.asList()

，这些 API 同样返回不可修改视图：

Collections.singletonList(x)

、

Collections.emptyList()

、

Collections.unmodifiableSet(...)

—— 全都不支持任何修改操作

Map.of()

和

Map.copyOf()

（Java 10+）返回的也是不可变

Map

，调

put()

就崩某些框架返回的“只读配置列表”（如 Spring 的

getBeanNamesForType()

结果）也可能被包装成不可修改集合，不能假设“是 List 就能 add” 真正容易被忽略的是：异常不是在构造时抛，而是在第一次修改调用时才暴露 —— 本地测试可能走不到那条分支，上线后某个边缘流程突然触发，才看到

UnsupportedOperationException

堆栈里藏着一行

list.add(...)

。

相关文章