Collections.checkedMap() 是 Java 运行时类型安全检查工具，包装 Map 后在 put/putAll/compute 等写入操作时校验键值类型，不检查读取和已有数据，依赖 Class 参数做 instanceof 判断，不支持通配符泛型，适用于开发测试阶段快速暴露类型错误。
Collections.checkedMap() 是 Java 提供的运行时类型安全检查工具，用于在向 Map 插入键（key）或值（value）时，强制校验其实际类型是否与泛型声明一致。它不会改变原有 Map 的行为，而是在每次 put、putAll、compute 等修改操作时做即时检查，一旦类型不匹配就抛出 ClassCastException。
核心用法：包装已有 Map 实例
必须传入一个已创建的原始 Map（如 HashMap），以及明确的键、值类型 Class 对象：
Map<String, Integer> safeMap = Collections.checkedMap(new HashMap<>(), String.class, Integer.class);
此后所有写入操作都会被拦截检查。例如：
-
safeMap.put("age", 25);✅ 正常执行 -
safeMap.put(123, "hello");❌ 运行时报ClassCastException（键不是 String） -
safeMap.put("name", "Alice");❌ 运行时报错（值不是 Integer）
只检查写入，不检查读取和构造
checkedMap 不会对已有数据做初始化扫描，也不检查 get() 返回值类型（因为泛型擦除后无法验证）。它只在 插入/更新 时校验新键值的类型：
- 如果用非泛型 Map 初始化（如
new HashMap()），再用 checkedMap 包装，它不会清理已有非法元素 - 建议在 Map 创建后**立即包装**，避免中间插入错误类型
- 读操作（
get、entrySet()等）仍按原逻辑返回，但返回值需由调用方自行保证类型安全
注意泛型擦除与运行时限制
checkedMap 依赖 Class 参数做 instanceof 判断，因此有以下约束：
- 不能用于带通配符或复杂泛型的类型（如
List<String>作为 value 类型需传List.class，但无法区分List<String>和List<Integer>） - 对基本类型包装类有效（
Integer.class），但不能传int.class（会抛IllegalArgumentException） - 子类实例允许（如
safeMap.put("k", new AtomicInteger(1))会通过，若 value 类型是Number.class）
替代方案与适用场景
checkedMap 适合开发/测试阶段快速暴露类型误用，但不适合生产环境高频写入场景（有额外反射开销）。更健壮的做法包括：
- 使用不可变容器（如
Map.of()、ImmutableMap）配合编译期检查 - 自定义封装类，在 setter 中显式校验并提供清晰错误信息
- 结合静态分析工具（如 Error Prone）在编译期捕获泛型误用
