Collections.checkedList 是 Java 提供的运行时类型安全包装器，通过动态检查 add/set/addAll 等操作中待添加对象是否符合指定类型（instanceof 校验）来防止 ClassCastException，但不校验已有元素，仅对 List 接口调用生效。
Collections.checkedList 是 Java 提供的一种运行时类型安全包装器，它在向 List 添加元素时**动态检查类型**，防止插入不兼容类型的对象，从而避免 ClassCastException 在后续取值时才暴露的问题。
核心原理：包装原始列表，拦截 add / set / addAll 等操作
checkedList 不改变原列表结构，而是返回一个代理 List 实例。每次调用 add()、set()、addAll()、retainAll() 等修改方法前，都会用 instanceof 检查待添加对象是否属于指定类型（或其子类）。
注意：它只检查写入，不检查已有元素——所以必须确保底层列表初始化时就只含合法类型，否则构造时不会校验，后续读取可能仍出错。
基本用法：传入原始列表和期望的运行时类型
语法：Collections.checkedList(list, type)，其中 type 是 Class<T> 对象（如 String.class）。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 底层列表可以是任意
List实现（ArrayList、LinkedList等），但建议用可变长实现 - 返回的是
List<T>，编译期有泛型提示，运行期强制校验 - 类型参数
T必须是具体类或接口（不能是类型变量，如T.class不合法）
示例：
List<String> rawList = new ArrayList<>();
List<String> safeList = Collections.checkedList(rawList, String.class);
safeList.add("hello"); // ✅ 允许
safeList.add(123); // ❌ 抛出 ClassCastException
safeList.set(0, "world"); // ✅
safeList.set(0, new Object()); // ❌
关键限制与注意事项
-
不检查构造前内容：如果原始列表已含非法对象，checkedList 不会在构造时抛错；首次访问该元素（如
get()）时才可能失败（取决于底层实现） -
仅对 List 接口方法生效：绕过接口直接操作底层列表（如强转后调用
rawList.add(new Date())）会破坏类型安全 -
泛型擦除不影响运行时检查：虽然泛型在运行时不存在，但
String.class提供了明确的类型信息，检查有效 - 无法阻止反射或序列化绕过：这是运行时防护，非语言级类型系统保障
适用场景与替代建议
适合在模块边界或 API 返回值中提供“弱类型安全”保障，比如：
- 对外暴露的 List 返回值，防止调用方误塞错误类型
- 测试中模拟类型约束环境
- 遗留代码中快速加一层防护（比完全重构成本低）
但更推荐的方式仍是：
- 使用泛型 + 编译期检查（主防线）
- 必要时配合不可变集合（
Collections.unmodifiableList）防篡改 - 复杂场景用自定义封装类，结合构造验证和完整行为控制
