【Java踩坑笔记】14_Collections.singletonList的坑：不能add也不能set

摘要：Collections.singletonList()返回的 List 是"只读"的，调用add()或set()会抛UnsupportedOperationException。不止如此，它还有一些你不知道的性能特点。

一、问题现象

publicclassSingletonListTest{publicstaticvoidmain(String[]args){List<String>list=Collections.singletonList("hello");list.add("world");// ❌ UnsupportedOperationExceptionlist.set(0,"hi");// ❌ UnsupportedOperationExceptionlist.remove(0);// ❌ UnsupportedOperationExceptionSystem.out.println(list.get(0));// ✅ "hello"（get 可以）System.out.println(list.size());// ✅ 1（size 可以）}}

运行结果：

Exception in thread "main" java.lang.UnsupportedOperationException

不止singletonList，Arrays.asList()也有类似的坑。

二、踩坑现场

场景 1：把 singletonList 当普通 List 用

// ❌ 错误：以为 singletonList 返回的 List 是可修改的List<Order>orders=Collections.singletonList(newOrder(1L));orders.add(newOrder(2L));// ❌ UnsupportedOperationException

场景 2：Arrays.asList 的坑

// ❌ Arrays.asList 返回的 List 也不能 add/removeList<String>list=Arrays.asList("A","B","C");list.add("D");// ❌ UnsupportedOperationExceptionlist.remove(0);// ❌ UnsupportedOperationExceptionlist.set(0,"X");// ✅ 这个可以！（和 singletonList 不同）

关键区别：Arrays.asList()的 List可以set()，但不能add()/remove()（长度固定）。
Collections.singletonList()的 Listset()也不行（完全只读）。

场景 3：作为参数传递时，调用方修改了 List

publicvoidprocess(List<String>tags){tags.add("processed");// ❌ 如果 tags 是 singletonList，这里会炸}

三、原理解析

3.1 Collections.SingletonList 的实现

// Collections.singletonList 源码publicstatic<T>List<T>singletonList(To){returnnewSingletonList<>(o);}// 内部类 SingletonListprivatestaticclassSingletonList<E>extendsAbstractList<E>implementsRandomAccess,Serializable{privatefinalEelement;SingletonList(Eobj){element=obj;}publicintsize(){return1;}publicbooleancontains(Objectobj){returneq(obj,element);}publicEget(intindex){if(index!=0)thrownewIndexOutOfBoundsException("Index: "+index);returnelement;}// 没有重写 add/set/remove → 继承 AbstractList 的默认实现// AbstractList 的 add/set/remove 直接抛 UnsupportedOperationException}

为什么set()也不支持？

SingletonList里的element是用final修饰的，且set()方法没有被重写（继承而来，直接抛异常）。

3.2 Arrays.asList 的坑

// Arrays.asList 返回的是 Arrays 的内部类 ArrayList（不是 java.util.ArrayList！）publicstatic<T>List<T>asList(T...a){returnnewArrayList<>(a);}// 这个 ArrayList 是 Arrays 的内部类privatestaticclassArrayList<E>extendsAbstractList<E>{privatefinalE[]a;// final 数组引用！@OverridepublicEset(intindex,Eelement){EoldValue=a[index];a[index]=element;// ✅ set 可以（修改数组元素）returnoldValue;}// 没有重写 add/remove → 抛 UnsupportedOperationException}

关键：Arrays.ArrayList的底层数组引用是final的（不能换数组），但数组里的元素可以修改（所以set()可以）。

3.3 性能特点

Collections.singletonList()比new ArrayList<>()更省内存：

new ArrayList<>()： - 创建一个 ArrayList 对象 - 创建一个 Object[] 数组（默认容量 10） - 内存开销：ArrayList 对象 + 数组头 + 10 个引用槽位 Collections.singletonList()： - 创建一个 SingletonList 对象 - 只存一个元素引用 - 内存开销：SingletonList 对象 + 1 个引用

结论：如果只需要一个元素的 List，用singletonList更省内存。

四、正确写法

4.1 需要可修改的 List：用 new ArrayList<>()

// ✅ 需要 add/removeList<String>list=newArrayList<>();list.add("hello");// ✅ 从 singletonList 转成可修改的 ListList<String>mutable=newArrayList<>(Collections.singletonList("hello"));mutable.add("world");// ✅

4.2 只需要只读 List：用 List.of()（Java 9+）

// ✅ Java 9+ 推荐用 List.of()List<String>list=List.of("hello");// 不可修改，比 singletonList 更通用List<String>list2=List.of("A","B","C");// 多个元素也支持

List.of()返回的是不可修改的 List，比Collections.unmodifiableList()更轻量。

4.3 需要不可修改但可能很大的 List：用 Collections.unmodifiableList()

// ✅ 把可修改的 List 包一层，变成只读视图List<String>mutable=newArrayList<>(Arrays.asList("A","B"));List<String>readOnly=Collections.unmodifiableList(mutable);readOnly.add("C");// ❌ UnsupportedOperationException// 但注意：如果修改了原 mutable List，readOnly 会看到变化（视图！）mutable.add("C");System.out.println(readOnly);// [A, B, C]（看到了变化）

4.4 防御性编程：返回只读 List

// ✅ 方法返回时，如果不希望调用方修改，返回只读 ListpublicList<String>getTags(){List<String>tags=newArrayList<>();tags.add("java");tags.add("spring");returnCollections.unmodifiableList(tags);// 调用方不能修改}

五、最佳实践

✅ 选择 List 的 5 条规则

🔍 常见误区

误区：「Arrays.asList()返回的 List 不能修改」
→更正：不能add/remove，但set()可以。

误区：「Collections.unmodifiableList()返回的是副本」
→更正：是视图，原 List 修改后，视图也能看到。

🛠️ Java 9+ 的 List.of() 优势

// Java 9+ 推荐用 List.of()，原因：// 1. 支持多个元素（不用先创建数组）// 2. 返回的 List 更省内存// 3. 不允许 null 元素（及早失败，避免 NPE）List<String>list=List.of("A","B","C");

六、小结

• Collections.singletonList()返回完全只读的 List（add/set/remove全不支持）
• Arrays.asList()返回的 List可以set()，但不能add()/remove()（长度固定）
• List.of()（Java 9+）是更好的选择，支持多元素且不可修改
• 需要可修改的 List，用new ArrayList<>()
• Collections.unmodifiableList()返回的是视图，不是副本

下一篇预告：Stream 并行流不是银弹，用错反而更慢—— 并行流默认用ForkJoinPool.commonPool()，在什么场景下用，什么场景下反而会拖慢性能？