java 解析json串

备案号:蜀ICP备2026035467号-3 | 网址:www.xservx.com

一、什么是 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 核心工具特性对比表

特性GsonJacksonFastjson
开发方GoogleFasterXML阿里巴巴
首次发布2008年2010年2012年
默认泛型支持需TypeToken原生支持需显式指定
循环引用处理需enableHtmlEscaping=false默认启用需手动设置
安全漏洞历史较少极低多次高危漏洞
Spring Boot默认否是否
流式解析APIJsonReader/JsonWriterJsonParser/JsonGeneratorJSONLexerBase

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 调试技巧

  1. 格式化JSON:使用ObjectMapper.writerWithDefaultPrettyPrinter()输出可读JSON
  2. 断点验证:在IDE中设置断点,检查中间变量类型
  3. 单元测试:用@Test覆盖正常/异常场景
  4. 日志增强:记录原始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);
        }
    }
}