FastJson2与Spring 6整合配置详解：别再只引入一个fastjson2依赖了-编程实验室

FastJson2与Spring 6整合配置详解：模块化设计的正确打开方式

在Java生态中，JSON处理库的选型一直是开发者关注的焦点。FastJson以其出色的性能表现赢得了大量用户的青睐，但随着FastJson2的发布，许多开发者发现简单的依赖升级并不能让项目正常运行——那些熟悉的类突然找不到了。这背后反映的不仅是API的变化，更是FastJson2在架构设计上的重大革新：从"大而全"到"模块化"的转变。

1. FastJson2模块化设计的核心理念

FastJson2的模块化设计并非一时兴起，而是为了解决FastJson1时代遗留的几个关键问题。在FastJson1中，所有功能都被打包在一个庞大的JAR中，无论你是否需要Spring集成、Kotlin支持或其他扩展功能，这些代码都会随着核心库一起被引入。这种设计带来了几个明显的弊端：

依赖冗余：不需要的功能增加了包体积
升级困难：任何功能的修改都需要发布整个库
兼容性挑战：难以针对不同框架版本提供适配

FastJson2通过模块化拆分完美解决了这些问题。以下是核心模块及其职责：

模块名称	功能描述	是否必需
fastjson2	核心JSON处理功能，包括基本序列化/反序列化	必需
fastjson2-extension	扩展功能支持，如日期格式化、特殊类型处理	可选
fastjson2-extension-spring6	专为Spring 6设计的集成支持	按需

这种设计带来的直接好处是：

更精细的依赖控制
更小的包体积
更灵活的版本管理
更好的框架兼容性

2. 典型问题解析：为什么类找不到了

许多开发者在升级到FastJson2时遇到的第一个问题就是FastJsonHttpMessageConverter等类无法解析。这个问题的根源在于：

类路径变化：FastJson2重新组织了包结构
- FastJson1:com.alibaba.fastjson.support.spring
- FastJson2:com.alibaba.fastjson2.support.spring6
模块分离：与Spring集成的功能被移到了独立模块
- 核心模块不再包含Spring相关类
- 需要显式引入fastjson2-extension-spring6
版本适配：针对不同Spring版本提供了不同模块
- Spring 5:fastjson2-extension-spring5
- Spring 6:fastjson2-extension-spring6

提示：如果你看到类似"找不到FastJsonHttpMessageConverter"的错误，99%的情况是缺少了对应的扩展模块。

3. 正确配置FastJson2与Spring 6集成

要让FastJson2在Spring 6项目中正常工作，需要完成以下几个步骤：

3.1 依赖配置

首先，确保你的pom.xml中包含所有必要的依赖：

<!-- 核心库 --> <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>

3.2 消息转换器配置

接下来，在Spring配置中设置FastJsonHttpMessageConverter：

@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 ); 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); } }

3.3 常见配置选项

FastJson2提供了丰富的配置选项，以下是一些常用设置：

日期格式：config.setDateFormat("yyyy-MM-dd")
序列化特性：
- JSONWriter.Feature.WriteMapNullValue- 序列化null值
- JSONWriter.Feature.PrettyFormat- 美化输出
反序列化特性：
- JSONReader.Feature.FieldBased- 基于字段而非getter/setter
- JSONReader.Feature.SupportArrayToBean- 支持数组转对象

4. 高级应用与性能优化

4.1 自定义序列化/反序列化

对于特殊类型的处理，可以注册自定义的序列化器：

config.getSerializeFilters().add(new ValueFilter() { @Override public Object apply(Object object, String name, Object value) { // 自定义处理逻辑 if (value instanceof BigDecimal) { return ((BigDecimal) value).setScale(2, RoundingMode.HALF_UP); } return value; } });

4.2 性能调优建议

重用配置对象：FastJsonConfig的创建成本较高，应该重用
选择合适的特性：不必要的特性会影响性能
考虑使用JSONB：对于高性能场景，FastJson2提供了二进制JSON支持

4.3 与Spring Boot的自动配置

如果你使用Spring Boot，可以创建自动配置类来简化设置：

@AutoConfiguration @ConditionalOnClass({FastJsonHttpMessageConverter.class}) public class FastJsonAutoConfiguration { @Bean @ConditionalOnMissingBean public FastJsonConfig fastJsonConfig() { FastJsonConfig config = new FastJsonConfig(); // 默认配置 return config; } @Bean @ConditionalOnMissingBean public FastJsonHttpMessageConverter fastJsonHttpMessageConverter(FastJsonConfig config) { FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter(); converter.setFastJsonConfig(config); return converter; } }