Java 中使用 Alibaba Fastjson 解析泛型类型 JsonResult＜SysUserDTO＞ 的问题

解决 Java 中使用 Alibaba Fastjson 解析泛型类型JsonResult<SysUserDTO>的问题。

核心问题

由于 Java 的类型擦除机制，直接解析泛型类会丢失泛型参数信息，导致SysUserDTO无法正确反序列化。

解决方案

方案一：使用TypeReference（推荐）

java

复制

import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.TypeReference; String jsonStr = "{\"code\":200,\"data\":{\"userId\":1,\"username\":\"admin\"},\"message\":\"success\"}"; // 关键：使用 TypeReference 保留泛型信息 JsonResult<SysUserDTO> result = JSON.parseObject(jsonStr, new TypeReference<JsonResult<SysUserDTO>>() {}); SysUserDTO user = result.getData();

方案二：使用Type对象

java

复制

import com.alibaba.fastjson.JSON; import java.lang.reflect.Type; // 构建带泛型的 Type Type resultType = new com.alibaba.fastjson.TypeReference<JsonResult<SysUserDTO>>() {}.getType(); JsonResult<SysUserDTO> result = JSON.parseObject(jsonStr, resultType);

方案三：先解析为 JSONObject，再转换

java

复制

import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; // 先解析外层 JsonResult result = JSON.parseObject(jsonStr, JsonResult.class); // 手动转换 data 字段 Object dataObj = result.getData(); SysUserDTO user = JSON.parseObject(JSON.toJSONString(dataObj), SysUserDTO.class);

方案四：使用 Fastjson2（新版 API）

如果你使用的是 Fastjson2：

java

复制

import com.alibaba.fastjson2.JSON; import com.alibaba.fastjson2.TypeReference; JsonResult<SysUserDTO> result = JSON.parseObject(jsonStr, new TypeReference<JsonResult<SysUserDTO>>() {});

完整示例

java

复制

import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.TypeReference; public class JsonDemo { public static void main(String[] args) { String json = "{\n" + " \"code\": 200,\n" + " \"message\": \"操作成功\",\n" + " \"data\": {\n" + " \"userId\": 1001,\n" + " \"username\": \"zhangsan\",\n" + " \"email\": \"zhangsan@example.com\"\n" + " }\n" + "}"; // ✅ 正确做法 JsonResult<SysUserDTO> result = JSON.parseObject(json, new TypeReference<JsonResult<SysUserDTO>>() {}); System.out.println("Code: " + result.getCode()); System.out.println("User: " + result.getData().getUsername()); } } // 定义类 @Data public class JsonResult<T> { private Integer code; private String message; private T data; } @Data public class SysUserDTO { private Long userId; private String username; private String email; }

常见错误 ❌

java

复制

// 错误！会导致 data 被解析为 LinkedHashMap JsonResult<SysUserDTO> result = JSON.parseObject(jsonStr, JsonResult.class);

依赖配置

xml

复制

<!-- Fastjson 1.x --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.83</version> </dependency> <!-- Fastjson2 --> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>2.0.43</version> </dependency>

总结

表格

复制

核心要点：解析带泛型的类时，必须使用TypeReference来保留完整的泛型信息，否则 Fastjson 无法知道T具体是什么类型。