Java Map值类型转换：多类型Map入参适配固定泛型方法的实现方案

核心适配需求 #

需要开发满足以下两个约束的method1方法：

• 方法可接收所有以String为键、值为任意引用类型的Map实例入参，例如Map<String, User>、Map<String, Employee>、Map<String, Account>等不同值类型的Map都可合法传入
• 方法内部必须调用签名完全固定、不可修改的method2，该方法仅接收Map<String, Object>类型的入参

常规实现的常见问题 #

实现1：入参直接定义为Map<String, Object> #

• 实现逻辑：将method1的入参类型直接设为Map<String, Object>，内部无需额外处理即可直接调用method2传参，调用过程无编译或运行异常
• 存在缺陷：受Java泛型不协变规则限制，Map<String, User>这类值类型为具体业务类的Map，不属于Map<String, Object>的兼容类型，method1完全无法接收这类入参，无法满足多类型Map的适配要求

实现2：入参使用? extends Object通配符 #

• 实现逻辑：将method1的入参调整为Map<String, ? extends Object>，此时方法可正常接收所有String为键的Map实例，完全满足多类型入参的要求
• 存在缺陷：内部直接调用method2时会触发编译报错，提示方法要求入参为Map<String, Object>类型，当前传入的是Map<String, capture of ? extends Object>类型，无法通过编译

最终适配方案 #

结合Java泛型的类型擦除机制，在不修改method2固定签名的前提下，可通过对入参做强制类型转换完成适配：

// 满足多类型入参要求的method1
public void method1(Map<String, ? extends Object> map) {
    // 强转为method2要求的类型后完成调用
    method2((Map<String, Object>) map);
}

// 不可修改的固定签名method2
public void method2(Map<String, Object> map) {
    // 原有业务逻辑保持不变
}

注意：该强转操作基于Java泛型的运行时擦除特性生效——编译期的通配符泛型信息不会被写入运行时的Map对象结构中，因此强转不会触发运行时类型校验错误。如果此前调整类型转换时出现运行异常，基本是强转的目标类型书写错误（比如误写为原生Map、键类型不匹配）导致的，将强转目标修正为Map<String, Object>后即可正常执行。

内容的提问来源于stack exchange，提问作者user13944893