Spring Boot集成fastjson2：高性能JSON处理实践
1. 为什么选择fastjson2作为Spring Boot的JSON处理器
在Java生态中，JSON处理库的选择一直是个值得讨论的话题。fastjson2作为阿里巴巴开源的JSON处理库，相比其他同类产品有几个显著优势：
首先是性能表现。根据官方基准测试，fastjson2在序列化和反序列化的速度上比Jackson和Gson快2-3倍。这对于高并发的Web应用来说意味着更低的延迟和更高的吞吐量。特别是在处理大型JSON数据时，这种性能优势会更加明显。
其次是功能丰富度。fastjson2支持JSONB二进制格式，这在需要网络传输或持久化存储的场景下能显著减少数据体积。它还内置了JSONPath支持，可以直接在JSON结构中进行查询和操作，这在处理复杂JSON时非常实用。
提示：虽然fastjson2性能优异，但在某些特殊场景下（如需要严格遵循JSON规范时），Jackson可能是更安全的选择。根据项目需求权衡选择很重要。
2. 项目环境搭建与依赖配置
2.1 创建Spring Boot项目
建议使用Spring Initializr（start.spring.io）创建一个基础的Spring Boot Web项目。选择以下依赖：
- Spring Web
- Lombok（可选，用于简化代码）
然后手动添加fastjson2的依赖。在pom.xml中添加：
<dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>2.0.40</version> </dependency> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-extension-spring5</artifactId> <version>2.0.40</version> </dependency>2.2 配置fastjson2作为默认消息转换器
Spring Boot默认使用Jackson处理JSON，我们需要替换为fastjson2。创建一个配置类：
@Configuration public class WebMvcConfig implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter(); FastJsonConfig config = new FastJsonConfig(); config.setDateFormat("yyyy-MM-dd HH:mm:ss"); config.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.SupportArrayToBean ); config.setWriterFeatures( JSONWriter.Feature.WriteMapNullValue, JSONWriter.Feature.PrettyFormat ); converter.setFastJsonConfig(config); converter.setDefaultCharset(StandardCharsets.UTF_8); converter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON)); converters.add(0, converter); } }这个配置做了几件事：
- 创建FastJsonHttpMessageConverter实例
- 配置日期格式
- 设置读取和写入特性
- 指定字符集和媒体类型
- 将转换器添加到转换器列表的首位
3. 基础使用示例
3.1 简单的REST接口
创建一个简单的控制器来测试fastjson2的集成：
@RestController @RequestMapping("/api") public class DemoController { @GetMapping("/user") public User getUser() { return new User(1L, "张三", 25, new Date()); } @PostMapping("/user") public User createUser(@RequestBody User user) { // 模拟保存操作 user.setId(100L); return user; } }User类定义：
@Data @NoArgsConstructor @AllArgsConstructor public class User { private Long id; private String name; private Integer age; private Date createTime; }测试这个接口，你会看到返回的JSON格式美观（因为配置了PrettyFormat特性），日期格式也符合我们的配置。
3.2 集合和复杂对象处理
fastjson2处理集合和复杂对象同样简单：
@GetMapping("/users") public List<User> getUsers() { List<User> users = new ArrayList<>(); users.add(new User(1L, "张三", 25, new Date())); users.add(new User(2L, "李四", 30, new Date())); return users; } @GetMapping("/complex") public Map<String, Object> getComplexData() { Map<String, Object> data = new HashMap<>(); data.put("success", true); data.put("code", 200); data.put("data", getUsers()); data.put("timestamp", System.currentTimeMillis()); return data; }4. 高级特性与配置
4.1 自定义序列化和反序列化
有时我们需要对特定字段进行特殊处理。fastjson2提供了几种方式：
- 使用@JSONField注解：
@Data public class Product { private Long id; @JSONField(name = "product_name") private String name; @JSONField(format = "￥#.00") private BigDecimal price; @JSONField(serialize = false) private String internalCode; }- 实现ObjectSerializer和ObjectDeserializer接口：
public class CustomDateSerializer implements ObjectSerializer { @Override public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, long features) { Date date = (Date) object; SimpleDateFormat format = new SimpleDateFormat("yyyy/MM/dd"); String text = format.format(date); serializer.write(text); } } // 注册自定义序列化器 FastJsonConfig config = new FastJsonConfig(); config.getSerializeConfig().put(Date.class, new CustomDateSerializer());4.2 JSONPath的使用
fastjson2内置了JSONPath支持，可以直接在JSON结构中进行查询：
String json = "{\"store\":{\"book\":[{\"category\":\"reference\",\"author\":\"Nigel Rees\",\"title\":\"Sayings of the Century\",\"price\":8.95},{\"category\":\"fiction\",\"author\":\"Evelyn Waugh\",\"title\":\"Sword of Honour\",\"price\":12.99}],\"bicycle\":{\"color\":\"red\",\"price\":19.95}}}"; // 获取所有书的作者 JSONPath.eval(json, "$.store.book[*].author"); // 获取价格大于10的书 JSONPath.eval(json, "$.store.book[?(@.price > 10)]"); // 修改自行车颜色 JSONPath.set(json, "$.store.bicycle.color", "blue");5. 常见问题与解决方案
5.1 日期处理问题
fastjson2处理日期时可能会遇到几个常见问题：
- 日期格式不一致：建议在实体类中使用@JSONField统一指定格式
@JSONField(format = "yyyy-MM-dd HH:mm:ss") private Date createTime;- 时区问题：可以在配置中设置时区
FastJsonConfig config = new FastJsonConfig(); config.setDateFormat("yyyy-MM-dd HH:mm:ss"); config.setWriterFeatures(JSONWriter.Feature.UseISO8601DateFormat);5.2 BigDecimal精度问题
如示例中提到的，BigDecimal在序列化时可能会丢失精度。解决方案：
// 单个序列化使用WriteBigDecimalAsPlain特性 String json = JSON.toJSONString(obj, JSONWriter.Feature.WriteBigDecimalAsPlain); // 全局配置 FastJsonConfig config = new FastJsonConfig(); config.setWriterFeatures(JSONWriter.Feature.WriteBigDecimalAsPlain);5.3 循环引用问题
当对象存在循环引用时，fastjson2默认会检测并抛出异常。可以通过配置来处理：
// 忽略循环引用 config.setWriterFeatures(JSONWriter.Feature.DisableCircularReferenceDetect); // 或者使用引用标识 config.setWriterFeatures(JSONWriter.Feature.ReferenceDetection);6. 性能优化建议
- 重用JSON实例：JSON和JSONB实例是线程安全的，可以重用
// 在类中定义静态实例 private static final JSONWriter.Context writerContext = new JSONWriter.Context( JSONFactory.getDefaultObjectWriterProvider(), JSONWriter.Feature.PrettyFormat ); // 使用时 String json = JSON.toJSONString(obj, writerContext);- 选择合适的特性：根据场景启用或禁用特性会影响性能
// 对于只读场景，可以禁用一些特性提高性能 config.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.UseNativeObject );- 考虑使用JSONB：对于需要频繁传输或存储的场景，JSONB能减少体积
// 序列化为JSONB byte[] jsonbBytes = JSONB.toBytes(obj); // 从JSONB反序列化 MyObject obj = JSONB.parseObject(jsonbBytes, MyObject.class);7. 实际项目中的集成经验
在实际项目中集成fastjson2时，我总结了以下几点经验：
统一配置：建议创建一个统一的配置类管理所有fastjson2相关配置，而不是分散在各处。
版本管理：fastjson2仍在积极开发中，建议在pom.xml中通过属性管理版本号：
<properties> <fastjson2.version>2.0.40</fastjson2.version> </properties> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>${fastjson2.version}</version> </dependency>- 与Swagger集成：如果项目使用Swagger生成API文档，需要额外配置：
@Bean public HttpMessageConverters fastJsonHttpMessageConverters() { FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter(); // ... 配置converter return new HttpMessageConverters(converter); }- 监控与日志：可以注册ParserConfig的globalInstance来监控反序列化过程：
ParserConfig.getGlobalInstance().addObserver(new ParserConfig.Observer() { @Override public void onObserve(Type type, Object fieldName, Object fieldValue) { // 记录反序列化过程 } });- 测试覆盖：特别要测试边界情况，如大数字、特殊字符、空值等。