摘要：
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 条规则
| 需求 | 推荐方式 | 是否可修改 |
|---|---|---|
| 只有一个元素 | List.of(e)/Collections.singletonList(e) | ❌ 不可修改 |
| 多个元素，不需要修改 | List.of(a, b, c) | ❌ 不可修改 |
| 需要 add/remove | new ArrayList<>() | ✅ 可修改 |
| 需要 set，不需要 add/remove | Arrays.asList(...) | ⚠️ 可 set，不可 add/remove |
| 返回只读视图 | Collections.unmodifiableList(list) | ❌ 不可修改（原 List 修改会影响它） |
🔍 常见误区
误区：「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()，在什么场景下用，什么场景下反而会拖慢性能？
