Collections.checkedCollection 是 Java 运行时类型安全包装器，通过在 add/addAll 等写操作时立即检查元素类型防止 ClassCastException，要求传入已创建的具体集合实例且不可为其他 checked 包装器，仅保障写入安全，不提供线程安全或读取时类型验证。
Collections.checkedCollection 是 Java 提供的一种运行时类型安全包装器，它在向集合添加元素时强制检查类型，防止插入不兼容类型的对象，从而避免 ClassCastException 在后续遍历或取值时才暴露的问题。
核心作用：在 add/addAll 时立即失败，而非延迟报错
未加检查的泛型集合（如 ArrayList<String>）在运行时会擦除类型信息。若通过原始类型引用误插入其他类型（如 list.add(123)），编译器不拦，但之后调用 String s = list.get(0) 就会抛异常。checkedCollection 把这个失败点前移到插入时刻，提升可调试性。
基本用法：包装已有集合，指定元素类型
语法为：Collections.checkedCollection(collection, type)，返回一个动态代理包装器。注意：必须传入**已创建好的具体集合实例**，且该集合本身不能是 checked 包装器（否则会抛 IllegalArgumentException）。
示例：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
List<String> rawList = new ArrayList<>();
List<String> safeList = Collections.checkedCollection(rawList, String.class);
safeList.add("hello"); // ✅ 正常
safeList.add(123); // ❌ ClassCastException：试图添加 Integer 到 String 集合
仅检查写操作，读操作仍需注意类型安全
checkedCollection 只拦截 add、addAll、set（对 List）等修改方法。它不检查底层集合是否已被非法修改（比如绕过包装器直接操作原始集合），也不影响迭代器或 get 的返回类型——你仍需按声明类型使用返回值。
常见风险点：
- 不要保留对原始集合的引用，否则可能被意外污染
- 如果集合被多个线程并发访问，checkedCollection 不提供线程安全，需额外同步
- 对 Map 不适用 —— 应使用
Collections.checkedMap；对 List/Set/Queue 才用 checkedCollection 或其专用变体（如checkedList、checkedSet）
与泛型声明、Collections.unmodifiableXXX 的区别
泛型只在编译期约束；unmodifiable 系列只防修改，不验类型；checked 系列专注“类型正确性+可修改”，三者可组合使用（例如先 checked 再 unmodifiable，实现类型安全且不可变）：
List<String> base = new ArrayList<>(); List<String> typeSafe = Collections.checkedList(base, String.class); List<String> immutableSafe = Collections.unmodifiableList(typeSafe);
