SpringBoot3整合FastJSON2：高性能JSON处理实战

1. SpringBoot3与FastJSON2整合背景解析

在Java生态中，JSON序列化/反序列化是Web开发的基础需求。FastJSON作为阿里开源的JSON处理工具，以其高性能著称，而FastJSON2是其全面升级版本。SpringBoot3作为最新一代的微服务框架，默认使用Jackson作为JSON处理器，但在高并发场景下，开发者常需要替换为性能更优的FastJSON2。

注意：FastJSON2并非简单升级版，而是完全重构的版本，API和配置方式都有显著变化，直接沿用FastJSON1.x的配置会导致兼容性问题。

1.1 为什么选择FastJSON2

FastJSON2相较于Jackson和FastJSON1.x具有三大核心优势：

1. 性能提升：反序列化性能比Jackson快50%以上，序列化速度提升约30%
2. 内存优化：采用全新内存模型，GC压力降低40%
3. 安全增强：修复了FastJSON1.x中已知的所有安全漏洞

实测数据对比（基于JMH基准测试）：

2. 基础环境搭建

2.1 依赖配置要点

在pom.xml中添加依赖时需特别注意版本兼容性：

xml复制<!-- 必须排除默认的Jackson -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-json</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- FastJSON2核心依赖 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.64</version>
</dependency>

<!-- SpringBoot3适配扩展 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2-extension-spring6</artifactId>
    <version>2.0.64</version>
</dependency>

踩坑提醒：SpringBoot3基于Spring6开发，必须使用fastjson2-extension-spring6扩展包，使用普通spring5扩展包会导致HttpMessageConverter不兼容。

2.2 基础配置类实现

创建配置类继承WebMvcConfigurer：

java复制@Configuration
public class FastJsonConfig implements WebMvcConfigurer {
    
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 1. 创建FastJson2转换器实例
        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
        
        // 2. 配置序列化规则
        FastJsonConfig config = new FastJsonConfig();
        config.setDateFormat("yyyy-MM-dd HH:mm:ss");
        config.setWriterFeatures(
            WriteEnumUsingToString,
            WriteMapNullValue,
            WriteNullListAsEmpty
        );
        
        // 3. 设置支持的MediaType
        converter.setSupportedMediaTypes(Arrays.asList(
            MediaType.APPLICATION_JSON,
            new MediaType("application", "*+json")
        ));
        
        // 4. 将转换器添加到转换器列表的首位
        converters.add(0, converter);
    }
}

3. 高级配置详解

3.1 自定义序列化规则

对于复杂对象需要特殊处理时，可以注册自定义序列化器：

java复制config.setSerializeFilters(new ValueFilter() {
    @Override
    public Object apply(Object object, String name, Object value) {
        // 对Long类型处理防止前端精度丢失
        if (value instanceof Long && name.endsWith("Id")) {
            return String.valueOf(value);
        }
        return value;
    }
});

// 配置全局的序列化修改器
config.setWriterFeatures(
    WriteEnumUsingToString,
    WriteMapNullValue,
    WriteNullListAsEmpty,
    WriteBigDecimalAsPlain
);

3.2 反序列化安全配置

为防止JSON注入攻击，必须配置反序列化参数：

java复制config.setReaderFeatures(
    AutoCloseSource,
    UseBigDecimalForDoubles,
    SupportArrayToBean
);

// 设置最大解析长度限制
config.setMaxLength(1024 * 1024); // 1MB

4. 性能优化实战

4.1 启用ASM加速

FastJSON2支持ASM字节码增强来提升性能：

java复制// 在配置类中添加初始化代码
static {
    // 启用ASM优化
    System.setProperty("fastjson2.asm.enable", "true");
    // 预热常用类
    JSONFactory.getDefaultObjectWriterProvider().register(Member.class);
}

4.2 缓存配置建议

对于高并发场景，需要调整缓存策略：

java复制// 设置缓存大小（默认256）
JSONFactory.setCacheSize(1024);

// 开启线程局部缓存
config.setSerializerFeatures(SerializerFeature.UseThreadLocalCache);

5. 常见问题排查

5.1 日期格式不生效

问题现象：前端传参的日期字符串无法正确绑定到LocalDateTime字段。

解决方案：

java复制// 需要额外配置日期解析器
config.setReaderFeatures(UseISO8601DateFormat);
config.setDateFormat("yyyy-MM-dd HH:mm:ss");

5.2 循环引用导致栈溢出

处理方案：

java复制// 方式1：禁用循环引用检测（不推荐）
config.setSerializerFeatures(SerializerFeature.DisableCircularReferenceDetect);

// 方式2：使用$ref处理（推荐）
config.setSerializerFeatures(SerializerFeature.WriteMapNullValue);

5.3 字段丢失问题

当遇到字段未被序列化时，检查：

1. 字段修饰符是否为private且没有getter方法
2. 是否被@JSONField(serialize=false)标记
3. 父类字段需要显式配置：

java复制config.setWriterFeatures(WriteClassName);

6. 生产环境最佳实践

6.1 多环境差异化配置

建议通过Profile区分不同环境的配置：

java复制@Profile("dev")
@Bean
public FastJsonConfig devFastJsonConfig() {
    // 开发环境保留更多调试信息
}

@Profile("prod")
@Bean
public FastJsonConfig prodFastJsonConfig() {
    // 生产环境追求极致性能
}

6.2 监控与调优

添加健康检查端点监控FastJSON2状态：

java复制@Endpoint(id = "fastjson")
public class FastJsonHealthEndpoint {
    
    @ReadOperation
    public Map<String, Object> health() {
        return Map.of(
            "cacheSize", JSONFactory.getCacheSize(),
            "asmEnabled", JSONFactory.isUseJacksonAnnotation()
        );
    }
}

在实际项目中使用发现，当QPS超过5000时，建议：

1. 调大JSONFactory的缓存大小
2. 对热点DTO类进行预编译
3. 禁用非必要的SerializerFeature