如何使用 Collectors.toUnmodifiableList() 方法获取一个不可变列表？

本文共计723个文字，预计阅读时间需要3分钟。

它返回的确切类型是 `java.util.ImmutableCollections.ListN`（JDK 10+）或类似不可变实现。所谓的不可修改仅指在运行时抛出 `UnsupportedOperationException`，并不阻止反射、序列化反序列化或通过原始引用绕过。例如，如果你用它收集一个已存在的可变 `ArrayList` 的副本，结果看起来是不可变的；但如果元素本身是可变的，集合本身不可增删改，元素状态仍可变。

真正安全的三步操作：深拷贝 + 不可变容器 + 元素冻结

要让结果集“绝对不可修改”，得同时控制容器和内容：

• 用 Collectors.collectingAndThen() 包裹原始收集器，再套一层深拷贝逻辑（如 new ArrayList(list) 或手动克隆）
• 对每个元素调用其 copy()、toImmutable() 或构造不可变副本（如 String 已不可变，但 LocalDateTime 需注意是否被意外修改）
• 最后才用 Collectors.toUnmodifiableList() 封装容器

示例（假设 User 有不可变构造器）：

list.stream() .map(u -> new User(u.getId(), u.getName(), u.getRole())) .collect(Collectors.collectingAndThen( Collectors.toList(), Collections::unmodifiableList ));

常见误用：把 toUnmodifiableList() 当作“防篡改保险柜”

以下情况它完全无效：

• 流中元素是 ArrayList、HashMap 等可变对象 → 容器不可变，但里面的内容随时能被改
• 收集前流源本身被外部持有并修改（如 stream().peek(...) 后又操作原集合）→ 不可变结果只是快照，源头还在动
• 在非 final 字段中暴露该列表引用，且未做防御性拷贝 → 调用方可能把它转成 ArrayList 再强转

尤其注意：JDK 9+ 的 Lists.of() 和 toUnmodifiableList() 都不检查元素是否可变，只管容器结构。

替代方案对比：什么时候该换别的方法

如果真需要“绝对不可修改”，优先考虑：

• 用 immutables.org 或 AutoValue 生成不可变值类，配合 toUnmodifiableList() → 从源头锁死数据形态
• 用 Guava 的 ImmutableList.copyOf()，它会对传入的 Collection 做防御性拷贝（但依然不深拷贝元素）
• 自定义 collector，内部用 StreamSupport.stream(..., false) + 手动遍历 + 每个元素 clone() → 控制粒度最细，但也最易出错

最常被忽略的一点：不可变性是分层的。容器、元素、元素字段——三层里只要有一层可变，整个结果就不是“绝对不可修改”。