UnsupportedOperationException出现在调用不支持的操作时，如对Collections.unmodifiableList创建的只读列表执行add或remove操作，导致运行时异常。
在Java中，UnsupportedOperationException 是一个运行时异常（RuntimeException），表示请求的操作不被当前对象支持。它通常出现在使用某些不可变集合、只读视图或未完全实现的接口方法时。正确理解和处理这个异常，有助于提升程序健壮性和开发效率。
为什么会出现 UnsupportedOperationException？
这个异常不是由程序逻辑错误直接导致，而是表明调用了一个“合法但不被支持”的操作。常见场景包括：
-
对不可变集合执行修改操作：比如通过
Collections.unmodifiableList()创建的列表，调用其add()或remove()</)</li> <li><font color="#0000FF">使用Arrays.asList() 返回的固定大小列表进行增删</font>：<code>Arrays.asList()
返回的 List 不支持添加或删除元素 - 自定义类未实现某个接口方法：例如实现 Iterator 时，未提供 remove() 功能却调用了它
- 使用空占位对象或桩对象（Stub）：测试或框架中临时实现的方法抛出此异常作为提醒
如何避免和处理该异常？
与其等到运行时报错，不如从设计和编码阶段规避问题。
-
明确集合是否可修改：如果需要修改集合，不要使用
Collections.unmodifiableXXX()包装后的对象。若需副本，可创建新的 ArrayList 等可变容器：List<string> modifiable = new ArrayList(Collections.unmodifiableList(original));</string> -
慎用 Arrays.asList()：它返回的是
java.util.Arrays.ArrayList（内部类），仅支持 get、set、contains，不支持增删。如需变更，请包装成新 ArrayList：List<string> list = new ArrayList(Arrays.asList(arr));</string> -
自定义实现时合理处理不支持的方法：如果你实现一个接口但某些方法暂时无意义，可以抛出
UnsupportedOperationException，但应文档说明。
例如：public boolean add(String s) { throw new UnsupportedOperationException("添加操作不被支持"); } - 提前检查类型或能力：某些情况下可通过 instanceof 判断实际类型是否支持操作，尤其是在泛型或接口编程中。
异常捕获是否推荐？
一般不建议主动 try-catch 这个异常，因为它属于编程错误而非运行时意外。正确的做法是预防而非事后处理。
立即学习“Java免费学习笔记（深入）”；
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
但如果在通用代码中处理多种集合类型，且不确定是否支持修改，可以选择先判断或使用防御性编程：
if (list instanceof ArrayList) {
list.add(item); // 安全调用
}
或者封装判断逻辑，避免触发异常。
总结与最佳实践
UnsupportedOperationException 的本质是“契约未满足”。处理它的关键是：
- 理解所用集合或对象的语义（可变 vs 只读）
- 避免对不可变结构执行写操作
- 使用 asList 或 unmodifiable 方法后，如需修改，应复制到可变容器
- 自定义类中明确哪些操作不支持，并给出清晰提示
基本上就这些。这个异常本身不难解决，关键在于清楚每个对象的能力边界。只要编码时多留意文档和返回类型，就能有效规避。
