1. 为什么选择FastJSON2替代JacksonSpring Boot默认集成Jackson作为JSON处理器但在某些场景下FastJSON2可能更具优势。FastJSON2是阿里巴巴开源的JSON处理库相比Jackson有以下特点性能优势FastJSON2在序列化/反序列化速度上比Jackson快30%-50%特别是在处理大JSON数据时更明显内存占用低FastJSON2的内存占用比Jackson减少约20%更简洁的APIFastJSON2的API设计更符合中国开发者的使用习惯更好的中文支持内置对中文日期格式、特殊字符等的处理注意FastJSON2需要Spring 6环境支持这也是为什么我们要使用fastjson2-extension-spring6这个扩展包2. 完整依赖配置详解2.1 Maven依赖配置除了基础依赖建议添加以下优化配置dependency groupIdcom.alibaba.fastjson2/groupId artifactIdfastjson2/artifactId version2.0.53/version /dependency dependency groupIdcom.alibaba.fastjson2/groupId artifactIdfastjson2-extension-spring6/artifactId version2.0.53/version /dependency2.2 Gradle配置如果使用Gradle构建项目implementation com.alibaba.fastjson2:fastjson2:2.0.53 implementation com.alibaba.fastjson2:fastjson2-extension-spring6:2.0.532.3 版本选择策略始终使用最新稳定版目前2.0.53避免使用SNAPSHOT版本主版本号升级可能有不兼容变更需要测试3. 深度配置FastJSON2消息转换器3.1 基础配置类实现Configuration public class Fastjson2Config implements WebMvcConfigurer { Override public void configureMessageConverters(ListHttpMessageConverter? converters) { FastJsonHttpMessageConverter converter new FastJsonHttpMessageConverter(); FastJsonConfig config new FastJsonConfig(); config.setDateFormat(yyyy-MM-dd HH:mm:ss); config.setWriterFeatures( WriteFeature.WriteMapNullValue, WriteFeature.WriteNullListAsEmpty, WriteFeature.WriteNullStringAsEmpty ); converter.setFastJsonConfig(config); converter.setDefaultCharset(StandardCharsets.UTF_8); converter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON)); // 添加到转换器列表首位 converters.add(0, converter); } }3.2 关键配置项说明日期格式setDateFormat()设置统一日期格式空值处理WriteMapNullValue序列化时保留null字段WriteNullListAsEmpty空列表序列化为[]WriteNullStringAsEmpty空字符串序列化为字符编码统一使用UTF-8媒体类型只处理application/json3.3 高级配置选项// 在FastJsonConfig中可添加的额外配置 config.setSerializerFeatures( SerializerFeature.PrettyFormat, // 美化输出 SerializerFeature.WriteClassName // 写入类名 ); // 自定义序列化器 config.setWriterFilters(new ValueFilter() { Override public Object apply(Object object, String name, Object value) { // 自定义序列化逻辑 return value; } });4. 实际应用场景示例4.1 Controller层使用RestController RequestMapping(/api) public class UserController { GetMapping(/user) public User getUser() { // 直接返回对象由FastJSON2自动序列化 return new User(1, 张三, LocalDateTime.now()); } PostMapping(/user) public User createUser(RequestBody User user) { // 自动反序列化请求体 return userService.save(user); } }4.2 自定义序列化/反序列化// 自定义日期序列化 JSON.register(LocalDateTime.class, (object, format) - { DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy年MM月dd日 HH时mm分); return formatter.format(object); }); // 使用TypeReference处理复杂泛型 ListUser users JSON.parseObject(jsonStr, new TypeReferenceListUser(){});5. 性能优化与最佳实践5.1 线程安全配置FastJSON2的核心对象都是线程安全的但建议FastJsonConfig实例应该单例使用避免频繁创建FastJsonHttpMessageConverter实例复杂对象的TypeReference应该缓存复用5.2 缓存策略// 启用缓存提高性能 FastJsonConfig config new FastJsonConfig(); config.setReaderFeatures(Feature.SupportAutoType); config.setWriterFeatures(WriteFeature.IgnoreErrorGetter);5.3 与Jackson共存方案如果需要同时支持FastJSON2和JacksonOverride public void configureMessageConverters(ListHttpMessageConverter? converters) { // FastJSON2转换器 FastJsonHttpMessageConverter fastJsonConverter createFastJsonConverter(); converters.add(0, fastJsonConverter); // 保留Jackson转换器 converters.add(new MappingJackson2HttpMessageConverter()); }6. 常见问题排查6.1 日期格式不生效可能原因配置类未正确加载 - 检查Configuration注解存在多个配置类冲突 - 检查Order注解实体类上有JsonFormat注解覆盖配置解决方案// 确保实体类不使用Jackson注解 Data public class User { private LocalDateTime createTime; // 会使用全局配置 }6.2 中文乱码问题解决方案确保设置了UTF-8编码检查HTTP响应头Content-Type避免在拦截器中修改响应编码6.3 循环引用问题FastJSON2默认检测循环引用可以通过配置关闭config.setSerializerFeatures(SerializerFeature.DisableCircularReferenceDetect);或者使用JSONField(serialize false)注解忽略特定字段7. 测试验证方案7.1 单元测试配置SpringBootTest AutoConfigureMockMvc class Fastjson2Test { Autowired private MockMvc mockMvc; Test void testJsonSerialization() throws Exception { mockMvc.perform(get(/api/user)) .andExpect(status().isOk()) .andExpect(jsonPath($.name).value(张三)) .andDo(print()); } }7.2 性能对比测试使用JMH进行序列化性能测试BenchmarkMode(Mode.Throughput) OutputTimeUnit(TimeUnit.SECONDS) public class JsonBenchmark { Benchmark public void fastjson2Serialize() { JSON.toJSONString(testData); } Benchmark public void jacksonSerialize() throws JsonProcessingException { new ObjectMapper().writeValueAsString(testData); } }8. 生产环境建议监控指标序列化/反序列化平均耗时JSON处理异常次数内存使用情况安全配置// 关闭自动类型识别防止安全漏洞 config.setReaderFeatures(Feature.SupportAutoType.masked);日志记录Slf4j Configuration public class Fastjson2Config implements WebMvcConfigurer { Override public void configureMessageConverters(ListHttpMessageConverter? converters) { // 配置完成后记录日志 log.info(FastJSON2配置加载完成当前版本{}, JSON.VERSION); } }在实际项目中我建议将FastJSON2的配置封装成独立的starter方便多项目复用。同时要注意定期更新FastJSON2版本修复可能的安全漏洞。对于特别复杂的JSON结构可以先进行性能测试再决定是否采用FastJSON2。