Java把JSON字符串转对象|完整指南与实战示例
一、为什么需要JSON字符串转对象?
在现代Web开发中,JSON(JavaScript Object Notation)已成为数据交换的事实标准。Java后端系统通过HTTP接口接收前端、移动端或微服务传递的JSON格式数据,必须将其转换为Java对象(POJO),才能进行业务逻辑处理、数据库持久化或对象映射。
例如,一个用户注册接口接收如下JSON:
{
"username": "zhangsan",
"email": "zhangsan@example.com",
"age": 28,
"roles": ["user", "member"]
}
若不转为对象,直接操作JSON字符串会导致代码可读性差、易出错、难以维护。因此,JSON字符串转对象是Java开发中的基础且高频操作。
主流框架(如Spring Boot)已内置JSON处理支持(默认使用Jackson),但理解底层原理与多库特性,有助于应对复杂场景(如性能瓶颈、兼容性问题、自定义反序列化)。
二、JSON转对象的核心原理
JSON字符串本质是文本,而Java对象是内存中的结构。转换过程包含两个阶段:
- 解析(Parsing):将JSON字符串按语法树结构分解为键值对、数组、嵌套对象等抽象结构(AST)。
- 映射(Mapping):根据目标类的字段名、类型、注解等信息,将AST中的数据填充到Java对象实例中。
关键点在于:字段名匹配策略(严格匹配 / camelCase转下划线 / 自定义映射)、类型推断(如JSON数字是int还是long?)、缺失字段处理(默认值 / null / 抛异常)。
例如,当JSON中缺少字段时:
- Gson:默认字段为null(基本类型除外)
- Jackson:默认字段为null;可配置`DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES`控制未知字段行为
- Fastjson:默认字段为null;支持`@JSONField(serialize = false)`忽略字段
开发者需结合业务需求选择处理策略。若前端传参不规范(如大小写混用),应使用注解或自定义`PropertyNamingStrategy`统一命名规范。
三、Gson库:Google出品,简洁易用
Gson是Google开源的JSON处理库,API设计简洁,无需为POJO添加注解,适合快速开发。
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.10.1</version>
</dependency>
import com.google.gson.Gson;
public class User {
private String username;
private String email;
private int age;
// getter / setter / toString
}
Gson gson = new Gson();
String json = "{\"username\":\"zhangsan\",\"email\":\"zs@test.com\",\"age\":28}";
User user = gson.fromJson(json, User.class);
System.out.println(user); // User{username='zhangsan', email='zs@test.com', age=28}
import com.google.gson.reflect.TypeToken;
String listJson = "[{\"username\":\"lisi\",\"email\":\"ls@test.com\",\"age\":25}, {\"username\":\"wangwu\",\"email\":\"ww@test.com\",\"age\":30}]";
List users = gson.fromJson(listJson, new TypeToken<List<User>>(){}.getType());
users.forEach(System.out::println);
public class User {
@com.google.gson.annotations.SerializedName("user_name")
private String username;
@com.google.gson.annotations.SerializedName("mail")
private String email;
private int age;
}
此时JSON可写为:
{
"user_name": "zhangsan",
"mail": "zs@test.com",
"age": 28
}
注意事项:Gson不支持泛型擦除后的类型推断(需显式声明`TypeToken`),且对超大JSON反序列化性能略逊于Jackson(但日常开发足够)。
四、Jackson:Spring生态默认引擎
Jackson是Java生态最广泛使用的JSON库,Spring Boot默认集成(`spring-boot-starter-web`自动引入),支持高性能流式处理与注解驱动。
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.3</version>
</dependency>
import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
String json = "{\"username\":\"lisi\",\"email\":\"ls@test.com\",\"age\":25}";
User user = mapper.readValue(json, User.class);
System.out.println(user);
String listJson = "[{\"username\":\"zhaoliu\",\"email\":\"zl@test.com\",\"age\":22}]";
List<User> users = mapper.readValue(listJson, new TypeReference<List<User>>(){});
users.forEach(System.out::println);
ObjectMapper mapper = new ObjectMapper();
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE); // user_name → username
也可在字段上使用`@JsonProperty`:
public class User {
@JsonProperty("user_name")
private String username;
}
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
防止前端多传字段导致报错,提升接口健壮性。
性能优势:Jackson的`Streaming API`(`JsonParser`/`JsonGenerator`)支持逐行处理超大JSON,内存占用低,适合日志分析、ETL等场景。
五、Fastjson:阿里开源,高性能之选
Fastjson由阿里巴巴开源,曾以“最快”闻名(2019年前),但因安全漏洞(如CVE-2019-9612)需谨慎使用。新项目建议优先选Gson/Jackson。
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2</artifactId>
<version>2.0.43</version>
</dependency>
注意:使用`fastjson2`(非`fastjson` 1.x),修复了历史漏洞。
import com.alibaba.fastjson2.JSON;
String json = "{\"username\":\"wangwu\",\"email\":\"ww@test.com\",\"age\":30}";
User user = JSON.parseObject(json, User.class);
System.out.println(user);
String listJson = "[{\"username\":\"chenqi\",\"email\":\"cq@test.com\",\"age\":27}]";
List<User> users = JSON.parseArray(listJson, User.class);
import com.alibaba.fastjson2.annotation.JSONField;
public class User {
@JSONField(name = "user_name")
private String username;
@JSONField(serialize = false) // 不序列化该字段
private String password;
}
性能实测:在百万级JSON解析任务中,Fastjson2比Jackson快约15%~25%,但需注意:
- 避免使用`JSON.parseObject(json, Object.class)`(类型擦除风险)
- 始终显式指定泛型类型
- 生产环境禁用`Feature.AllowUnQuotedFieldNames`等不安全特性
六、其他库对比速览
轻量级库,无依赖,适合Android小项目:
import org.json.JSONObject;
JSONObject obj = new JSONObject(jsonString);
String username = obj.getString("username");
int age = obj.getInt("age");
缺点:无POJO映射,需手动取值;不支持泛型;性能一般。
基于`org.json`和`commons-beanutils`,2011年后停止维护,严禁在新项目使用!存在严重安全漏洞。
Square开源,专为Kotlin设计,支持`@Json`注解:
Moshi moshi = new Moshi.Builder().build();
JsonAdapter<User> adapter = moshi.adapter(User.class);
User user = adapter.fromJson(json);
适合Kotlin多平台项目,但Java生态支持较弱。
七、主流库性能与功能对比
| 特性 | Gson | Jackson | Fastjson2 | org.json |
|---|---|---|---|---|
| 默认泛型支持 | 需TypeToken | 需TypeReference | ✅ 直接支持 | ❌ 手动解析 |
| 流式处理 | ❌ 仅支持DOM | ✅ JsonParser/Generator | ✅ JSONReader/Writer | ❌ |
| 注解丰富度 | 中 | 高 | 高 | 低 |
| 内存占用(大JSON) | 较高 | 低 | 低 | 低 |
| 2023年安全风险 | 低 | 低 | 中(需正确配置) | 低 |
| Spring Boot默认 | ❌ | ✅ | ❌ | ❌ |
选型建议:
- 常规Web项目 → Jackson(生态完善、配置灵活)
- 追求极致性能(非安全敏感) → Fastjson2(严格校验配置后)
- Android小项目/快速原型 → Gson(API简洁)
- 嵌入式设备/极简需求 → org.json
八、常见异常与解决方案
现象:JSON含目标类无的字段时抛出异常。
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "nickname"
解决:
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
现象:POJO无无参构造器或字段无setter。
解决:
- 添加无参构造器(即使私有也需存在)
- 使用`@JsonCreator` + `@JsonProperty`:
public class User {
private final String username;
@JsonCreator
public User(@JsonProperty("username") String username) {
this.username = username;
}
}
现象:JSON中`"2023-12-01 15:30:00"`无法转为`Date`。
Jackson解决:
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createTime;
Gson解决:
Gson gson = new GsonBuilder()
.setDateFormat("yyyy-MM-dd HH:mm:ss")
.create();
现象:`"age": ""`导致`NumberFormatException`。
解决:全局配置默认值:
// Jackson
mapper.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);
或使用包装类型`Integer`替代`int`。
九、实战技巧与最佳实践
public class JsonUtils {
private static final ObjectMapper MAPPER = new ObjectMapper()
.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
public static <T> T toObject(String json, Class<T> clazz) {
try { return MAPPER.readValue(json, clazz); }
catch (Exception e) { throw new RuntimeException("JSON解析失败", e); }
}
}
// Jackson
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// Fastjson2
JSON.toJSONString(obj, JSONWriter.Feature.WriteNulls);
对象A含B,B含A时,Jackson需:
@JsonManagedReference
private B b;
@JsonBackReference
private A a;
或使用`@JsonIdentityInfo`(主键标识):
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class A { ... }
将`Date`序列化为时间戳(Long):
// Jackson
@JsonFormat(shape = JsonFormat.Shape.NUMBER)
private Date createTime;
禁用`autoType`(Fastjson2):
JSON.parseObject(json, User.class, Feature.DisableAutoType);
Jackson使用`TypeReference`限定类型范围,避免`Object.class`。
十、网友最关心的10个问题
JSON字符串转对象 vs 转Map?
两种方式对比:
- 转POJO:类型安全、IDE提示、编译期检查,适合结构稳定的接口。
- 转Map(如`Map
`):灵活处理动态JSON,适合字段不定的场景(如配置中心)。
示例:
// 转Map
Map<String, Object> map = mapper.readValue(json, new TypeReference<Map<String, Object>>(){});
System.out.println(map.get("username"));
建议:业务核心逻辑用POJO;通用中间件(如网关)用Map。
超大JSON解析内存溢出(OOM)?
问题场景:解析100MB+ JSON文件时`OutOfMemoryError`。
解决方案:
- 使用流式API(Jackson `JsonParser`):
try (JsonParser parser = mapper.getFactory().createParser(new File("large.json"))) {
while (parser.nextToken() != null) {
if (parser.getCurrentName().equals("user")) {
User user = parser.readValueAs(User.class);
// 处理单个对象
}
}
}
- 分块解析(按行读取JSON Lines格式)
- 用`Streaming`模式:`mapper.enable(JsonParser.Feature.STREAMING)`
微服务中如何统一JSON格式?
跨服务调用时,JSON字段不一致导致解析失败。
最佳实践:
- 定义
OpenAPI 3.0规范,强制字段名/类型统一 - 使用
@JsonProperty映射不同命名风格(如snake_case → camelCase) - 网关层做JSON转换(如Kong插件)
示例:将前端传的`user_name`映射为`username`:
public class UserRequest {
@JsonProperty("user_name")
private String username;
}
Java 17+ 是否需升级JSON库?
Java 17本身不包含JSON处理库,仍需第三方依赖。
但新特性可优化JSON处理:
- Record类(Java 16+)简化POJO定义:
public record User(String username, String email, int age) { }
Jackson/Gson可直接反序列化到Record(需配置`DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES`)。
- Pattern Matching for instanceof简化类型判断:
if (obj instanceof User user) {
System.out.println(user.username());
}
十一、附录:JSON转对象全流程图
JSON字符串
↓ [解析]
抽象语法树(AST)
↓ [映射]
目标类定义(POJO)
↓ [填充字段]
Java对象实例
↓ [业务处理]
数据库/缓存/响应
关键环节:字段名匹配 → 类型转换 → 缺失值处理 → 循环引用规避