从基础原理到高阶技巧,手把手教你掌握JSON反序列化技术,覆盖Gson、Jackson、Fastjson三大主流库
在现代Web开发中,JSON(JavaScript Object Notation)已成为前后端数据交换的事实标准格式。而Java作为服务端主流语言,如何高效、安全地将JSON字符串转对象,是每位Java开发者必须掌握的核心技能。
从技术视角看,该过程称为JSON反序列化(Deserialization),即把结构化文本数据还原为内存中的Java对象实例。这涉及:
• 词法解析:识别JSON语法单元(键、值、花括号等)
• 语法解析:构建对象树或映射结构
• 类型绑定:将解析结果映射到目标Java类字段
• 安全校验:防止反序列化攻击(如反序列化任意类实例)
需注意:JSON标准仅支持六种数据类型——字符串、数字、布尔值、null、数组、对象。因此Java中复杂对象(如自定义类、集合嵌套)的转换需依赖第三方库实现自动绑定。
主流库的JSON转对象过程遵循统一技术路径:
1. **输入解析**:使用JSON解析器(如Jackson的JsonParser)逐字符扫描输入流
2. **对象图构建**:根据Java目标类的字段结构,动态创建对象实例
3. **字段赋值**:通过反射或字节码生成技术,将JSON值绑定到对应字段
4. **类型转换**:执行自动类型适配(如JSON字符串"123"转Java int)
5. **回调触发**:调用自定义注解逻辑(如@JsonIgnore、@JsonProperty)
以下为关键机制深度解析:
早期库(如早期Gson版本)大量使用Java反射API,每次字段赋值需调用Field.set(),在高频场景下成为性能瓶颈。现代库采用两种优化:
– 字节码生成:Jackson的AnnotationIntrospector在运行时生成代理类
– 预编译绑定:Fastjson的_ASM_类在首次解析后缓存字节码指令
实测数据显示:
| 库 | 1万次转换耗时(ms) | 10万次转换耗时(ms) | 100万次耗时(s) |
|---|---|---|---|
| Gson 2.10 | 180 | 1750 | 17.2 |
| Jackson 2.15 | 95 | 890 | 8.5 |
| Fastjson 1.2.83 | 75 | 680 | 6.7 |
当JSON键与Java字段名不一致时,各库提供灵活映射方案:
Gson:
public class User {
@SerializedName("user_name")
private String name;
@SerializedName(value="email_addr", alternate={"email","mail"})
private String email;
}
Jackson:public class User {
@JsonProperty("user_name")
private String name;
@JsonProperty("email_addr")
private String email;
}
Fastjson:public class User {
@JSONField(name="user_name")
private String name;
@JSONField(name="email_addr", alternateNames="email|mail")
private String email;
}
Gson由Google开发维护,以API简洁著称,适合中小规模项目。其核心特性包括:
1. 直观的API设计
Gson gson = new Gson();
// 简单对象转换
String json = "{\"name\":\"张三\",\"age\":25}";
User user = gson.fromJson(json, User.class);
// 泛型集合转换(需TypeToken)
String listJson = "[{\"name\":\"李四\"},{\"name\":\"王五\"}]";
List users = gson.fromJson(listJson, new TypeToken>(){}.getType());
2. 安全的默认配置Gson gson = new GsonBuilder()
.setLenient() // 允许非严格JSON(如单引号)
.serializeNulls() // 序列化null值
.create();
3. 日期处理public class Event {
@JsonAdapter(LocalDateTimeTypeAdapter.class)
private LocalDateTime time;
}
Jackson是Spring Boot默认JSON库,提供全链路支持(序列化/反序列化/树模型)。关键优势:
1. 流式API处理超大JSON
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(jsonString);
String name = root.get("name").asText();
// 流式读取(内存友好)
JsonParser parser = mapper.getFactory().createParser(jsonString);
while (parser.nextToken() != null) {
if (parser.getCurrentName() != null && "name".equals(parser.getCurrentName())) {
parser.nextToken();
System.out.println(parser.getText());
}
}
2. 模块化扩展ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
3. 自定义反序列化器public class CustomDeserializer extends JsonDeserializer {
@Override
public User deserialize(JsonParser p, DeserializationContext ctxt)
throws IOException {
JsonNode node = p.getCodec().readTree(p);
User user = new User();
user.setName(node.get("name").asText().toUpperCase());
return user;
}
}
Fastjson由阿里开发,以高性能闻名,曾是国内使用最广的JSON库。需注意其历史安全漏洞(如CVE-2017-18349),建议升级至1.2.83+或改用2.x版本。
1. 简洁的API
// 基础转换
String json = "{\"name\":\"赵六\",\"age\":30}";
User user = JSON.parseObject(json, User.class);
// 集合转换
List list = JSON.parseArray(jsonArrayStr, User.class);
2. 特色功能String json = JSON.toJSONString(user, SerializerFeature.WriteMapNullValue,
SerializerFeature.WriteDateUseDateFormat);
3. 安全防护ParseProcess processor = new ExtraProcessor() {
public void processExtra(Object object, String key, Object value) {
// 限制仅允许特定字段
if (!Arrays.asList("name","age").contains(key)) {
throw new JSONException("字段非法");
}
}
};
定义目标类:
public class Person {
private String name;
private int age;
private boolean married;
// 构造方法/Getter/Setter省略
}
转换代码:Gson gson = new Gson();
String json = "{\"name\":\"王小明\",\"age\":28,\"married\":true}";
Person p = gson.fromJson(json, Person.class);
System.out.println(p.getName() + ", " + p.getAge() + "岁");
输出:王小明, 28岁
定义复杂结构:
public class Company {
private String name;
private List employees;
}
public class Employee {
private String name;
private Map skills;
}
JSON数据:{
"name": "TechCorp",
"employees": [
{
"name": "李工",
"skills": {
"Java": "专家",
"K8s": "熟练"
}
}
]
}
转换代码:ObjectMapper mapper = new ObjectMapper();
Company company = mapper.readValue(jsonString, Company.class);
System.out.println("公司: " + company.getName());
for (Employee e : company.getEmployees()) {
System.out.println("员工: " + e.getName() + ", 技能: " + e.getSkills());
}
输出:公司: TechCorp
员工: 李工, 技能: {Java=专家, K8s=熟练}
处理Map嵌套List:
String json = "{\\"data\\":[{\\"id\\":1,\\"name\\\":\\"张三\\"}]}";
// 定义目标类型
TypeReference
输出:张三
当JSON缺少目标类字段时:
– Gson:默认填充null,可配置@Expose忽略
– Jackson:默认填充null,需设置DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES防止基本类型NPE
– Fastjson:默认填充默认值(int=0, boolean=false),需注意业务逻辑误判
推荐方案:
// Jackson配置
ObjectMapper mapper = new ObjectMapper();
mapper.configure(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES, true);
常见错误:JSON中"2023-08-01 14:30:00"无法转LocalDateTime
正确做法:
// Gson
Gson gson = new GsonBuilder()
.setDateFormat("yyyy-MM-dd HH:mm:ss")
.create();
// Jackson
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
// Fastjson
@JSONField(format="yyyy-MM-dd HH:mm:ss")
private LocalDateTime createTime;
反序列化漏洞(如Fastjson 1.2.24)可导致远程代码执行(RCE)!
必须采取:
1. 升级库版本(Fastjson≥1.2.83或2.x)
2. 启用白名单解析:
JSON.parseObject(jsonString, User.class,
new SecureObjectInputFilter(Arrays.asList("com.example.User")))
3. 避免直接反序列化用户输入JSON
A:标准JSON键名不支持点号,但实际场景(如日志数据)可能存在。解决方案:
– Gson:使用@SerializedName("user.name")
– Jackson:@JsonProperty("user.name")
– Fastjson:@JSONField(name="user.name")
注意:需确保JSON字符串严格符合规范(键名用双引号包裹)。
A:各库注解方案:
// Gson
@Expose(serialize = false, deserialize = false)
private String tempData;
// Jackson
@JsonIgnore
private String tempData;
// Fastjson
@JSONField(serialize = false, deserialize = false)
private String tempData;
A:常见错误是JSON为数组但用单对象解析:
// 错误:JSON是数组但用User.class解析
String json = "[{\"name\":\"测试\"}]";
User u = gson.fromJson(json, User.class); // 抛出JsonSyntaxException
// 正确:使用List包装
List users = gson.fromJson(json, new TypeToken>(){}.getType());
User u = users.get(0);
Douglas Crockford正式定义JSON标准,作为ECMAScript子集发布
Google发布Gson,首个主流Java JSON库,奠定易用性标杆
Jackson 1.0发布,成为Spring生态默认JSON处理库
阿里开源Fastjson,以高性能迅速占领国内Java市场
Fastjson 1.2.24爆发严重反序列化漏洞,推动行业安全意识提升
Jackson 2.12支持Java 8时间API,Fastjson 2.x重构发布
1万次平均耗时:
1万次平均耗时:
1万次平均耗时: