告别FastJson1，拥抱FastJson2：Spring 6/Spring Boot 3项目配置消息转换器全攻略

从FastJson1到FastJson2：Spring 6时代的高性能JSON解析方案

JSON作为现代Web开发中最常用的数据交换格式，其处理效率直接影响着系统性能。在Java生态中，FastJson凭借其卓越的解析速度长期占据重要地位。但随着Spring 6和Spring Boot 3的发布，FastJson2作为全新升级版本，带来了更优的性能和更好的框架适配性。本文将深入探讨如何在Spring 6+环境中正确配置FastJson2，充分发挥其性能优势。

1. FastJson2的核心升级与优势

FastJson2并非简单的版本迭代，而是从架构层面进行了全面重构。相比FastJson1，它在以下几个方面实现了显著提升：

• 性能飞跃：序列化/反序列化速度提升30%-50%，内存占用减少20%
• 安全性增强：修复了FastJson1中已知的安全漏洞，提供更严格的类型检查
• 模块化设计：将功能拆分为核心库和扩展模块，按需引入减少依赖体积
• 更好的Spring 6+支持：专门为Spring 6提供了适配模块，完美兼容Reactive编程模型

// FastJson2与FastJson1的包结构对比 // FastJson1 import com.alibaba.fastjson.support.config.FastJsonConfig; import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter; // FastJson2 import com.alibaba.fastjson2.support.config.FastJsonConfig; import com.alibaba.fastjson2.support.spring6.http.converter.FastJsonHttpMessageConverter;

提示：FastJson2的包路径中明确包含了"spring6"，这是其专门为Spring 6适配的重要标志

2. 项目依赖配置详解

正确引入FastJson2需要三个核心组件，缺一不可：

Maven配置示例：

<dependencies> <!-- FastJson2核心库 --> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>2.0.49</version> </dependency> <!-- 扩展功能支持 --> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-extension</artifactId> <version>2.0.49</version> </dependency> <!-- Spring 6专用适配器 --> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-extension-spring6</artifactId> <version>2.0.49</version> </dependency> </dependencies>

Gradle用户可以使用以下配置：

implementation 'com.alibaba.fastjson2:fastjson2:2.0.49' implementation 'com.alibaba.fastjson2:fastjson2-extension:2.0.49' implementation 'com.alibaba.fastjson2:fastjson2-extension-spring6:2.0.49'

3. 消息转换器完整配置指南

在Spring 6环境中配置FastJsonHttpMessageConverter需要特别注意以下几点：

1. 媒体类型设置变化：不再推荐使用MediaType.APPLICATION_JSON_UTF8
2. 默认字符集配置方式调整
3. 特征开关更加精细化

以下是一个完整的配置示例：

@Configuration public class WebMvcConfig implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter(); // 配置FastJson参数 FastJsonConfig config = new FastJsonConfig(); config.setDateFormat("yyyy-MM-dd HH:mm:ss"); // 设置读取特征 config.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.SupportArrayToBean, JSONReader.Feature.AllowUnQuotedFieldNames ); // 设置写入特征 config.setWriterFeatures( JSONWriter.Feature.WriteMapNullValue, JSONWriter.Feature.PrettyFormat, JSONWriter.Feature.WriteBigDecimalAsPlain ); converter.setFastJsonConfig(config); converter.setDefaultCharset(StandardCharsets.UTF_8); converter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON)); // 将FastJson转换器添加到首位 converters.add(0, converter); } }

关键配置项说明：

• ReaderFeatures：控制反序列化行为

  • FieldBased：基于字段而非getter方法
  • SupportArrayToBean：支持数组直接转对象
  • AllowUnQuotedFieldNames：允许不带引号的字段名

• WriterFeatures：控制序列化行为

  • WriteMapNullValue：输出空值字段
  • PrettyFormat：美化输出格式
  • WriteBigDecimalAsPlain：避免科学计数法

4. 高级特性与性能优化

FastJson2提供了多项高级功能，合理使用可以进一步提升系统性能：

4.1 循环引用检测优化

FastJsonConfig config = new FastJsonConfig(); // 禁用循环引用检测可提升性能，但需确保数据无循环引用 config.setWriterFeatures(JSONWriter.Feature.DisableCircularReferenceDetect);

4.2 自定义序列化器

config.setWriterFilters(new ValueFilter() { @Override public Object apply(Object object, String name, Object value) { if (value instanceof Date) { return ((Date) value).getTime(); // 日期转为时间戳 } return value; } });

4.3 多线程安全配置

FastJson2内部做了大量线程安全优化，但在高并发场景下，建议：

1. 为每个线程创建独立的JSONReader/JSONWriter实例
2. 重用FastJsonConfig对象减少配置开销
3. 对频繁使用的类型启用预编译

// 类型预编译示例 JSONFactory.getDefaultObjectWriterProvider().register(User.class);

4.4 与Spring Reactive集成

对于WebFlux项目，可以配置如下：

@Bean public FastJson2HttpMessageConverter fastJson2HttpMessageConverter() { FastJson2HttpMessageConverter converter = new FastJson2HttpMessageConverter(); FastJsonConfig config = new FastJsonConfig(); // 配置同上 converter.setFastJsonConfig(config); return converter; }

5. 迁移注意事项与常见问题

从FastJson1升级到FastJson2需要注意以下关键点：

• 包路径变更：所有com.alibaba.fastjson引用需改为com.alibaba.fastjson2
• API变化：
  • JSON.parseObject()方法签名调整
  • 部分Feature枚举值重命名
• 行为差异：
  • 日期格式处理更严格
  • 空值处理策略变化

常见问题解决方案：

1. ClassNotFoundException：

   • 检查是否完整引入了三个必要依赖
   • 确认包路径是否正确

2. 序列化格式不符预期：

   • 检查WriterFeatures配置
   • 验证自定义过滤器和序列化器

3. 性能未达预期：

   • 启用合适的Feature组合
   • 考虑预编译高频使用的类型

// 新旧API对比示例 // FastJson1 User user = JSON.parseObject(jsonString, User.class); // FastJson2 (推荐方式) User user = JSON.parseObject(jsonString, User.class, JSONReader.Feature.FieldBased);

在实际项目中，我们通常会建立一个兼容层来平滑过渡：

public class JsonUtils { private static final FastJsonConfig config = new FastJsonConfig(); static { config.setReaderFeatures(JSONReader.Feature.FieldBased); config.setWriterFeatures(JSONWriter.Feature.WriteMapNullValue); } public static String toJson(Object obj) { return JSON.toJSONString(obj, config); } public static <T> T fromJson(String json, Class<T> clazz) { return JSON.parseObject(json, clazz, config); } }

6. 性能对比与最佳实践

我们通过基准测试对比不同场景下的性能表现：

基于实测数据，我们总结出以下最佳实践：

1. 合理配置Feature：根据业务特点启用必要的Feature，避免过度配置
2. 重用配置对象：FastJsonConfig线程安全，应重用而非频繁创建
3. 类型预编译：对核心DTO进行预编译可提升20%-30%性能
4. 避免过度美化：生产环境应禁用PrettyFormat以减少网络开销
5. 合理处理null值：根据前端需求决定是否输出null字段

对于高并发系统，还可以考虑以下优化手段：

// 高性能配置示例 FastJsonConfig highPerfConfig = new FastJsonConfig(); highPerfConfig.setWriterFeatures( JSONWriter.Feature.FieldBased, JSONWriter.Feature.WriteNulls, JSONWriter.Feature.DisableCircularReferenceDetect ); highPerfConfig.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.UseNativeObject );

7. 与其他JSON库的对比

在Spring生态中，除了FastJson2，还有Jackson和Gson等可选方案。以下是主要对比：

选择建议：

• 极致性能场景：FastJson2
• 复杂业务需求：Jackson
• 简单轻量级应用：Gson
• Spring全栈项目：Jackson或FastJson2

在微服务架构中，可以混合使用不同解析库：

// 网关层使用FastJson2提升吞吐量 @Bean public HttpMessageConverters customConverters() { return new HttpMessageConverters(false, Arrays.asList( new FastJsonHttpMessageConverter(), new StringHttpMessageConverter() )); } // 内部服务使用Jackson保证最大兼容性 @Bean public ObjectMapper objectMapper() { return new ObjectMapper() .registerModule(new JavaTimeModule()) .disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); }