一、什么是 java 解析json串?
在现代Web开发中,java 解析json串已成为服务端与前端、服务端与第三方系统交互的核心能力。JSON(JavaScript Object Notation)作为一种轻量级的数据交换格式,具有结构清晰、易于阅读、语言无关等优势,被广泛应用于RESTful API、微服务通信、配置文件等场景。而java 解析json串,即指在Java语言环境中,将JSON格式的字符串转换为Java对象(反序列化),或将Java对象转换为JSON字符串(序列化)的过程。
需要注意的是,Java标准库并未原生提供JSON处理能力,因此开发者需借助第三方库实现。主流的java 解析json串工具包括Gson(Google)、Jackson(FasterXML)、Fastjson(阿里巴巴)、Moshi、Json-B等。各工具在性能、易用性、安全性、兼容性等方面各有侧重,开发者应根据项目需求合理选型。
从技术本质看,java 解析json串依赖于词法分析(Lexer)与语法分析(Parser)两个阶段:首先将JSON字符串分解为记号流(tokens),再依据JSON语法规则构建抽象语法树(AST),最终映射到Java类的实例。这一过程涉及递归下降解析、类型推断、泛型擦除处理、循环引用检测等关键技术点,对理解底层机制具有重要意义。
二、主流 java 解析json串 工具对比
2.1 工具选型核心维度
在选择java 解析json串框架时,需综合评估以下维度:
- 性能:吞吐量、内存占用、GC压力。Jackson通常在高并发下表现最优;Fastjson在单机压测中可能更快,但存在历史安全风险。
- API易用性:Gson提供简洁的ObjectMapper风格API;Jackson功能强大但配置项繁多;Fastjson API极简但易误用。
- 安全性:是否支持反序列化白名单、循环引用防护、DoS防护(如深度限制、循环检测)。Jackson默认安全,Gson需手动配置,Fastjson曾多次曝出RCE漏洞(如CVE-2021-21290)。
- 生态集成:Spring Boot默认集成Jackson;MyBatis、Hibernate等ORM框架对Jackson/Gson支持良好。
- 泛型支持:Jackson通过TypeReference保留泛型信息;Gson支持TypeToken;Fastjson早期版本存在泛型擦除问题。
2.2 核心工具特性对比表
| 特性 | Gson | Jackson | Fastjson |
|---|---|---|---|
| 开发方 | FasterXML | 阿里巴巴 | |
| 首次发布 | 2008年 | 2010年 | 2012年 |
| 默认泛型支持 | 需TypeToken | 原生支持 | 需显式指定 |
| 循环引用处理 | 需enableHtmlEscaping=false | 默认启用 | 需手动设置 |
| 安全漏洞历史 | 较少 | 极低 | 多次高危漏洞 |
| Spring Boot默认 | 否 | 是 | 否 |
| 流式解析API | JsonReader/JsonWriter | JsonParser/JsonGenerator | JSONLexerBase |
2.3 性能实测参考(单线程处理10KB JSON)
在JDK 11、Spring Boot 2.7环境下,对包含200个字段的嵌套JSON进行10万次序列化/反序列化,平均耗时如下:
- Jackson:82ms(吞吐量12,195 ops/s)
- Gson:118ms(吞吐量8,474 ops/s)
- Fastjson 2.x:65ms(吞吐量15,384 ops/s)
注:Fastjson 1.x存在已知安全风险,不建议使用;Fastjson 2.x重构后性能显著提升,但仍需谨慎配置安全策略。
三、Gson:Google出品的优雅解析器
3.1 基础序列化与反序列化
Gson的核心类是Gson和GsonBuilder。以下为典型用法:
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
// 定义数据模型
class User {
private String name;
private int age;
private boolean active;
// 构造器、getter/setter省略
}
// 序列化:对象 → JSON字符串
Gson gson = new Gson();
User user = new User("张三", 28, true);
String json = gson.toJson(user);
// 输出:{"name":"张三","age":28,"active":true}
// 反序列化:JSON字符串 → 对象
String jsonInput = "{\"name\":\"李四\",\"age\":32,\"active\":false}";
User user2 = gson.fromJson(jsonInput, User.class);
System.out.println(user2.getName()); // 输出:李四
对于泛型类型(如List<User>),需使用TypeToken:
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;
Type listType = new TypeToken<List<User>>(){}.getType();
String jsonArray = "[{\"name\":\"王五\",\"age\":25,\"active\":true}]";
List<User> users = gson.fromJson(jsonArray, listType);
3.2 高级配置技巧
① 字段命名策略
处理下划线命名的JSON(常见于后端数据库):
Gson gson = new GsonBuilder()
.setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
.create();
示例:Java字段userName → JSON字段user_name
② 忽略字段
使用@Expose注解控制序列化字段:
class User {
@Expose
private String name;
@Expose(serialize = false, deserialize = false)
private String password;
}
构建Gson时启用excludeFieldsWithoutExposeAnnotation():
Gson gson = new GsonBuilder()
.excludeFieldsWithoutExposeAnnotation()
.create();
③ 自定义序列化器
处理特殊字段(如时间戳转ISO-8601):
class DateTimeSerializer implements JsonSerializer<java.util.Date> {
public JsonElement serialize(Date src, Type typeOfSrc, JsonSerializationContext context) {
return new JsonPrimitive(new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ").format(src));
}
}
Gson gson = new GsonBuilder()
.registerTypeAdapter(java.util.Date.class, new DateTimeSerializer())
.create();
3.3 常见问题与解决方案
① null值处理
Gson默认忽略null字段,可通过serializeNulls()保留:
Gson gson = new GsonBuilder()
.serializeNulls() // 输出null字段
.create();
② 循环引用异常
当对象存在循环引用(如双向关联)时,Gson默认会抛出StackOverflowError。解决方案:
- 使用
@Expose切断关联 - 启用
setPrettyPrinting()仅用于调试 - 在反序列化时用
setFieldNamingStrategy重命名字段避免死循环
③ 泛型擦除陷阱
错误写法:
// 错误!TypeToken必须在匿名内部类中创建
Type listType = new TypeToken<List<User>>(){}.getType();
正确做法:确保TypeToken在匿名类中实例化(如上所示),否则泛型信息丢失。
四、Jackson:企业级JSON处理首选
4.1 核心API:ObjectMapper
Jackson的核心是ObjectMapper,支持注解驱动与编程式配置:
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.JsonProcessingException;
ObjectMapper mapper = new ObjectMapper();
// 序列化
User user = new User("赵六", 30, true);
String json = mapper.writeValueAsString(user);
常用注解
| 注解 | 作用 | 示例 |
|---|---|---|
@JsonProperty | 指定JSON字段名 | @JsonProperty("user_name") private String name; |
@JsonIgnore | 忽略字段 | @JsonIgnore private String password; |
@JsonFormat | 日期格式化 | @JsonFormat(pattern="yyyy-MM-dd") private Date birthday; |
@JsonInclude | 控制null/空值输出 | @JsonInclude(JsonInclude.Include.NON_NULL) |
4.2 Spring Boot集成
Spring Boot默认使用Jackson,可通过application.yml配置:
spring:
jackson:
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
serialization:
write-dates-as-timestamps: false # 禁用时间戳
default-property-inclusion: non_null # 忽略null字段
自定义ObjectMapper Bean:
@Configuration
public class JacksonConfig {
@Bean
@Primary
public ObjectMapper objectMapper() {
ObjectMapper mapper = new ObjectMapper();
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
mapper.registerModule(new JavaTimeModule());
return mapper;
}
}
4.3 流式API:处理超大JSON
当JSON文件体积巨大(如1GB+),内存无法容纳时,使用JsonParser与JsonGenerator进行流式处理:
ObjectMapper mapper = new ObjectMapper();
JsonFactory factory = mapper.getFactory();
try (JsonParser parser = factory.createParser(new File("large.json"))) {
while (!parser.isClosed()) {
JsonToken token = parser.nextToken();
if (token == JsonToken.FIELD_NAME && "users".equals(parser.getCurrentName())) {
// 读取users数组
parser.nextToken(); // 跳到[符号
while (parser.nextToken() != JsonToken.END_ARRAY) {
User user = mapper.readValue(parser, User.class);
System.out.println(user.getName());
}
}
}
}
优势:内存占用恒定(仅加载当前处理节点),适合ETL、日志解析等场景。
五、Fastjson:性能与风险并存
5.1 Fastjson 1.x使用示例
API极简,但存在高危漏洞:
import com.alibaba.fastjson.JSON;
// 序列化
String json = JSON.toJSONString(user);
// 反序列化
User user = JSON.parseObject(json, User.class);
// 支持泛型(需指定Class)
List<User> users = JSON.parseArray(jsonArray, User.class);
严重漏洞提醒
- CVE-2017-18349:远程代码执行(RCE)
- CVE-2020-8840:任意类反序列化
- CVE-2021-21290:自动类型推断导致的RCE
强烈建议升级至Fastjson 2.x或切换至Jackson/Gson。
5.2 Fastjson 2.x升级指南
Fastjson 2.x(com.alibaba.fastjson2)重构底层,修复安全问题:
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONB;
// 序列化
byte[] bytes = JSONB.toBytes(user); // 二进制格式,更高效
String json = JSON.toJSONString(user);
// 反序列化
User user = JSON.parseObject(json, User.class);
User user2 = JSON.parseObject(bytes, User.class); // JSONB解码
性能提升
- 吞吐量提升2~5倍
- 内存占用减少40%
- 支持JSONB二进制协议(比JSON小50%)
5.3 安全配置规范
若必须使用Fastjson 1.x(不推荐),需严格配置白名单:
import com.alibaba.fastjson.parser.Feature;
import com.alibaba.fastjson.parser.ParserConfig;
import com.alibaba.fastjson.util.TypeUtils;
// 全局安全配置
ParserConfig.getGlobalInstance().setAutoTypeSupport(false);
TypeUtils.setInternalProperty("fastjson.autoTypeSupport", "false");
// 反序列化时启用白名单
User user = JSON.parseObject(json, User.class,
Feature.DisableAutoTypeSupport,
Feature.AllowUnNamedField);
白名单示例:
ParserConfig.getGlobalInstance().addAccept("com.example.model.");
ParserConfig.getGlobalInstance().addAccept("java.lang.String");
ParserConfig.getGlobalInstance().addAccept("java.util.ArrayList");
六、java 解析json串 常见异常与调试
6.1 典型异常类型
- com.fasterxml.jackson.core.JsonParseException:JSON语法错误(如缺少引号、逗号)
- com.fasterxml.jackson.databind.exc.MismatchedInputException:类型不匹配(如JSON中字符串"abc"无法转为int)
- com.google.gson.JsonSyntaxException:Gson反序列化失败(如字段缺失、类型转换错误)
- com.alibaba.fastjson.JSONException:Fastjson特有异常(如循环引用、类型不支持)
6.2 异常处理最佳实践
try {
User user = objectMapper.readValue(json, User.class);
} catch (JsonParseException e) {
logger.error("JSON格式错误: {}", e.getOriginalMessage());
} catch (JsonMappingException e) {
logger.error("字段映射失败: 字段'{}'无法映射到{}", e.getPath().get(0).getFieldName(), e.getTargetType().getSimpleName());
} catch (IOException e) {
logger.error("IO异常: {}", e.getMessage());
}
关键点:
- 捕获具体异常类型,避免使用
Exception泛泛处理 - 记录
JsonLocation定位错误位置(如行号、列号) - 对用户返回友好提示,避免泄露内部结构
6.3 调试技巧
- 格式化JSON:使用
ObjectMapper.writerWithDefaultPrettyPrinter()输出可读JSON - 断点验证:在IDE中设置断点,检查中间变量类型
- 单元测试:用
@Test覆盖正常/异常场景 - 日志增强:记录原始JSON(脱敏后)与目标类名
七、java 解析json串 最佳实践
7.1 性能优化建议
- 复用ObjectMapper/Gson:单例模式避免重复创建(线程安全)
- 使用流式API:处理大文件时避免OOM
- 禁用不需要的功能:如Jackson中
disable(Feature.FAIL_ON_UNKNOWN_PROPERTIES) - 缓存反序列化类:对高频类使用
WeakReference缓存TypeReference
7.2 安全规范
- 禁用自动类型推断:Fastjson设
autoTypeSupport=false;Jackson禁用DefaultTyping - 白名单机制:仅允许已知安全类反序列化
- 输入校验:检查JSON长度、嵌套深度(如Jackson的
JsonParser.setMaxDepth()) - 脱敏处理:敏感字段(密码、身份证)在序列化时隐藏
7.3 代码示例:通用JSON工具类
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.JsonProcessingException;
public class JsonUtil {
private static final ObjectMapper mapper = new ObjectMapper();
static {
// 全局配置
mapper.disable(JsonWriteFeature.ESCAPE_NON_ASCII);
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
mapper.registerModule(new JavaTimeModule());
}
public static String toJson(Object obj) {
try {
return mapper.writeValueAsString(obj);
} catch (JsonProcessingException e) {
throw new RuntimeException("JSON序列化失败", e);
}
}
public static <T> T fromJson(String json, Class<T> clazz) {
try {
return mapper.readValue(json, clazz);
} catch (JsonProcessingException e) {
throw new RuntimeException("JSON反序列化失败", e);
}
}
}