JSON.parseObject 返回 List 时不能强制转换的解决方案

1. 问题背景

在使用 Fastjson 或 Fastjson2 时,很多开发者习惯这样写:

java 复制代码
List<User> userList = (List<User>) JSON.parseObject(jsonString);

运行时会抛出 ClassCastException,提示无法将 JSONObject 或 JSONArray 强制转换为 List<User>。这是因为 JSON.parseObject 默认返回的是 JSONObject 类型,而不是泛型 List。

2. 错误原因分析

JSON.parseObject(String text) 的返回值类型是 JSONObject,它本质上是一个 Map。当 JSON 字符串是数组结构时,直接强转成 List 会失败。

java 复制代码
// 错误写法:运行时报 ClassCastException
List<User> userList = (List<User>) JSON.parseObject(jsonArrayString);

3. 正确解决方案

方案一:使用 TypeReference(推荐)

java 复制代码
import com.alibaba.fastjson.TypeReference;

List<User> userList = JSON.parseObject(jsonString, new TypeReference<List<User>>() {});

方案二:使用 parseArray

java 复制代码
List<User> userList = JSON.parseArray(jsonString, User.class);

方案三:先转 JSONArray 再遍历

java 复制代码
JSONArray array = JSON.parseArray(jsonString);
List<User> userList = array.toJavaList(User.class);

4. 完整示例

java 复制代码
public class JsonDemo {
    public static void main(String[] args) {
        String json = "[{\"name\":\"张三\",\"age\":20},{\"name\":\"李四\",\"age\":22}]";

        // 方式一:TypeReference
        List<User> list1 = JSON.parseObject(json, new TypeReference<List<User>>() {});

        // 方式二:parseArray
        List<User> list2 = JSON.parseArray(json, User.class);

        // 方式三:JSONArray 转换
        JSONArray array = JSON.parseArray(json);
        List<User> list3 = array.toJavaList(User.class);

        System.out.println(list1);
        System.out.println(list2);
        System.out.println(list3);
    }
}

5. 注意事项

  • 使用 TypeReference 时,泛型信息会被完整保留,不会因类型擦除而丢失。
  • parseArray 适用于 JSON 字符串本身就是数组的情况。
  • 如果 JSON 字符串是对象而非数组,应使用 JSON.parseObject(json, User.class) 解析为单个对象。
  • Fastjson2 中 API 基本一致,同样支持上述三种写法。
相关推荐
nice_lcj5201 小时前
【从零理解 Spring AI · 13】RAG 要解决什么:把“闭卷考试“变成“开卷“
java·spring·检索增强·rag·spring ai·ai应用开发
学长毕设2 小时前
基于SpringBoot军事纪念馆管理系统设计与实现-附源码
java·spring boot·后端
这个昵称不容易3 小时前
SpringBoot 医疗病历交互系统的设计与实现:192 个 Java 文件、256 个接口、22 张表,附真实运行截图
java·springboot·毕设
驭渊的小故事4 小时前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
文丑颜不良啊6 小时前
LeetCode3001~3020题目解析
java·leetcode
山楂树の7 小时前
Java 字符串高效处理:StringBuilder、StringBuffer、StringJoiner
java·开发语言
.痞老板.8 小时前
java ee--文件操作和IO
java·java-ee
简 洁 冬冬8 小时前
分页「向上取整」公式 `(total + size - 1) / size` 的完整推导
java·分页
装不满的克莱因瓶10 小时前
【从零搭建】AI大模型之ReactAgent智能体对接MCP实战
java·人工智能·ai·springai·mcp·springaialibaba
FRing0311 小时前
vue2干货总结10(json-server、vant-ui、postcss插件、axios二次封装、图形验证码、toast轻提示)
开发语言·前端·vue.js·ui·json·vue2·postcss