Java集合不可变性导致的UnsupportedOperationException怎么解决

Arrays.asList() 返回的 List 抛 UnsupportedOperationException，因其底层是固定大小的 Arrays$ArrayList，不支持增删操作，仅允许修改已有元素；需可变集合时应显式包装为 new ArrayList()。

为什么 Arrays.asList() 返回的 List 会抛 UnsupportedOperationException

因为 Arrays.asList() 返回的是一个固定大小、底层由原始数组支撑的 List 实现（Arrays$ArrayList），它不支持增删操作，只允许修改已有元素。调用 add()、remove()、clear() 等方法时直接抛出该异常。

常见错误现象：Exception in thread "main" java.lang.UnsupportedOperationException at java.util.Arrays$ArrayList.add(Arrays.java:...)

• 使用场景：把数组转成 List 后想动态增删——这是最典型的误用
• 参数差异：传入的数组类型不影响行为，无论 String[] 还是 Integer[]，返回的都是不可变结构
• 性能影响：它不复制数据，所以创建快、内存省，但代价是牺牲可变性
• 正确做法：需要可变 List 就必须显式包装，比如 new ArrayList<>(Arrays.asList(...))

哪些集合工厂方法返回的是不可变集合（Java 9+）

Java 9 引入的 List.of()、Set.of()、Map.of() 全部返回不可变实例，任何修改操作都会触发 UnsupportedOperationException。

错误示例：list.add("x") 在 list = List.of("a", "b") 后执行，立刻失败

• 使用场景：配置项、常量集合、函数返回值——设计初衷就是防误改
• 兼容性注意：Java 8 没有这些方法；Java 9+ 才有，且它们不接受 null 元素
• 和 Collections.unmodifiableList() 的区别：前者是真正不可变（无内部可变引用），后者只是“只读视图”，原集合变了它也会变
• 如果真要可变副本，老老实实用 new ArrayList<>(List.of(...))

如何安全地从不可变集合派生可变副本

不能靠强制类型转换，也不能依赖“看起来像能改”——必须走构造器或工具方法明确复制。

• new ArrayList<>(immutableList) 是最通用、最直观的方式
• 对 Stream 场景，用 stream().collect(Collectors.toCollection(ArrayList::new))
• 避免踩坑：ArrayList 构造器接收 Collection，但若传入的是 Collections.unmodifiableList() 包装过的对象，它只会复制引用，后续原集合被改仍会影响副本（除非原集合本身也不可变）
• 性能提示：复制有开销，大数据量时留意是否真需要可变性；小集合（几十个元素内）基本无感

自定义不可变类时，为什么 getXXX() 返回的集合还要再包装一次

即使你把字段声明为 private final List data; 并只提供 getItems()，如果直接返回 data，调用方仍可能 cast 成 ArrayList 并修改——这会破坏封装性。

• 正确做法：返回 Collections.unmodifiableList(data) 或 Java 10+ 的 List.copyOf(data)
• 区别：Collections.unmodifiableList() 是运行时防护，List.copyOf() 是浅拷贝且要求源非 null，更严格
• 容易忽略的点：如果 data 本身来自 Arrays.asList() 或 List.of()，它已经不可变，再包一层虽安全但冗余；但代码无法静态判断，所以统一处理更稳妥

事情说清了就结束。关键不是记住哪些方法抛异常，而是每次拿到一个 List 时，先问一句：它的生命周期和所有权归谁？是不是我亲手 new 出来的？