如何安全将Object转为Map<String,Object>及处理泛型List转换问题

问题原因 #

Java泛型采用类型擦除机制，运行时无法识别List<Map<String, Object>>这类泛型的具体参数类型，所以直接用instanceof List<Map<String, Object>>会报错；而直接强转List到泛型List会触发unchecked警告，因为编译器无法确认List内部元素的类型。

可行解决方案 #

1. 先校验List类型，再遍历验证内部元素

先判断对象是否为List，再逐个检查元素是否为Map，确认安全后再强转，同时抑制合法的unchecked警告：

Map<String, Object> jsonMap = ...; // 已解析的JSON Map
Object rowsObj = jsonMap.get("rows");

if (rowsObj instanceof List) {
    List<?> rawList = (List<?>) rowsObj;
    // 验证List中所有元素都是Map类型
    boolean allElementsAreMap = rawList.stream()
        .allMatch(item -> item instanceof Map);
    
    if (allElementsAreMap) {
        // 已确保类型安全，抑制unchecked警告
        @SuppressWarnings("unchecked")
        List<Map<String, Object>> rows = (List<Map<String, Object>>) rawList;
        // 执行后续业务逻辑
    } else {
        throw new IllegalArgumentException("List中存在非Map类型的元素");
    }
}

2. 利用Java 16+的instanceof模式匹配（语法简化）

Java 16增强了instanceof的模式匹配，可以直接绑定变量，逻辑和上面一致，但写法更简洁：

Object rowsObj = jsonMap.get("rows");

if (rowsObj instanceof List<?> rawList) {
    if (rawList.stream().allMatch(item -> item instanceof Map)) {
        @SuppressWarnings("unchecked")
        List<Map<String, Object>> rows = (List<Map<String, Object>>) rawList;
        // 业务逻辑处理
    }
}

3. 借助JSON解析库直接解析到目标类型

如果使用Gson、Jackson这类JSON库，可直接通过类型令牌（TypeToken）解析到List<Map<String, Object>>，跳过手动转换：

// Gson示例
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;

Gson gson = new Gson();
Type listOfMapType = new TypeToken<List<Map<String, Object>>>() {}.getType();
List<Map<String, Object>> rows = gson.fromJson(
    gson.toJson(jsonMap.get("rows")), 
    listOfMapType
);

注意事项 #

• 必须验证List内部元素的类型，否则强转后可能在后续操作中抛出ClassCastException
• 抑制unchecked警告时，务必确保已经完成足够的类型校验，避免潜在风险
• 优先使用JSON库的内置类型转换能力，减少手动处理的出错概率

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