1. FastJson输出JSON中的反斜杠问题解析最近在项目中使用FastJson进行JSON序列化时遇到了一个让人头疼的问题生成的JSON字符串中莫名其妙多出了反斜杠。这个问题看似简单但如果不理解背后的原理很容易陷入反复试错的困境。今天我就来详细分析这个问题的成因和解决方案。FastJson作为阿里巴巴开源的JSON处理库在国内Java开发者中应用广泛。但在实际使用JSON.toJSONString()方法时很多人会发现输出的JSON字符串中包含了不必要的转义字符特别是反斜杠\。这不仅影响JSON的可读性在某些场景下还会导致前端解析出错。2. 问题现象与成因分析2.1 典型问题表现假设我们有一个简单的Java对象public class User { private String name; private String email; // 构造方法、getter和setter省略 }当我们使用FastJson序列化时User user new User(); user.setName(张三); user.setEmail(zhangsanexample.com); String json JSON.toJSONString(user); System.out.println(json);预期输出应该是{email:zhangsanexample.com,name:张三}但有时实际输出却变成了{\email\:\zhangsanexample.com\,\name\:\张三\}2.2 问题根源探究造成这个问题的根本原因是FastJson的序列化层级和转义机制双重序列化当JSON.toJSONString()方法被多次调用时第二次调用会将第一次的结果视为普通字符串处理从而添加转义字符。默认序列化策略FastJson默认会对某些特殊字符进行转义包括引号、反斜杠等以确保JSON的有效性。框架集成问题在Spring等框架中如果Controller方法返回String类型框架可能会自动对返回值再次进行JSON序列化。3. 解决方案与最佳实践3.1 基础解决方案3.1.1 避免双重序列化确保JSON.toJSONString()只被调用一次。在Spring MVC中可以直接返回Java对象让框架处理序列化RestController public class UserController { GetMapping(/user) public User getUser() { User user new User(); user.setName(张三); user.setEmail(zhangsanexample.com); return user; // 让Spring处理序列化 } }3.1.2 使用合适的序列化配置FastJson提供了SerializerFeature配置来控制序列化行为String json JSON.toJSONString(user, SerializerFeature.WriteMapNullValue, SerializerFeature.QuoteFieldNames, SerializerFeature.SkipTransientField, SerializerFeature.PrettyFormat);3.2 高级配置方案3.2.1 自定义序列化器对于复杂场景可以实现自定义的序列化器public class CustomJsonSerializer implements ObjectSerializer { Override public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException { // 自定义序列化逻辑 } }然后注册到FastJson配置中SerializeConfig.getGlobalInstance().put(User.class, new CustomJsonSerializer());3.2.2 配置FastJsonHttpMessageConverter在Spring Boot中可以配置FastJson的消息转换器Configuration public class WebConfig implements WebMvcConfigurer { Override public void configureMessageConverters(ListHttpMessageConverter? converters) { FastJsonHttpMessageConverter converter new FastJsonHttpMessageConverter(); FastJsonConfig config new FastJsonConfig(); config.setSerializerFeatures( SerializerFeature.WriteMapNullValue, SerializerFeature.WriteNullStringAsEmpty, SerializerFeature.DisableCircularReferenceDetect ); converter.setFastJsonConfig(config); converters.add(0, converter); } }3.3 特殊情况处理3.3.1 处理HTML内容当JSON中包含HTML标签时FastJson会自动转义User user new User(); user.setName(scriptalert(xss)/script); String json JSON.toJSONString(user); // 输出会转义HTML标签如果不需要转义可以使用SerializerFeature.DisableCheckSpecialCharString json JSON.toJSONString(user, SerializerFeature.DisableCheckSpecialChar);3.3.2 处理特殊字符对于包含特殊字符如换行符、制表符的内容FastJson默认会转义user.setName(Line1\nLine2); String json JSON.toJSONString(user); // 输出会将\n转义为\\n如果希望保留原始格式可以结合DisableCheckSpecialChar和WriteSlashAsSpecial一起使用。4. 常见问题排查与调试技巧4.1 问题诊断步骤确认序列化层级检查JSON.toJSONString()是否被多次调用检查框架配置确认是否有多余的消息转换器查看中间结果在序列化前后打印中间结果简化测试用例创建最小复现示例4.2 典型错误与修正4.2.1 错误示例1手动序列化后框架再次序列化RestController public class UserController { GetMapping(/user) public String getUser() { User user new User(); user.setName(张三); return JSON.toJSONString(user); // 错误框架会再次序列化 } }修正方案直接返回对象GetMapping(/user) public User getUser() { User user new User(); user.setName(张三); return user; }4.2.2 错误示例2错误的消息转换器顺序Override public void configureMessageConverters(ListHttpMessageConverter? converters) { converters.add(new StringHttpMessageConverter()); // 错误字符串转换器在前 converters.add(new FastJsonHttpMessageConverter()); }修正方案调整转换器顺序Override public void configureMessageConverters(ListHttpMessageConverter? converters) { FastJsonHttpMessageConverter converter new FastJsonHttpMessageConverter(); // 配置converter... converters.add(0, converter); // 确保FastJson转换器优先 }4.3 调试技巧启用调试日志配置FastJson的日志级别为DEBUG使用拦截器在消息转换前后添加拦截器检查数据比较原始数据对比序列化前后的数据差异版本兼容性检查确认FastJson版本与其他库的兼容性5. 性能优化与安全考量5.1 序列化性能优化重用SerializeConfig避免重复创建配置对象选择合适的SerializerFeature禁用不必要的特性预编译序列化器对常用类预编译序列化器合理使用线程局部变量减少对象创建开销5.2 安全注意事项XSS防护谨慎使用DisableCheckSpecialChar敏感数据过滤避免序列化敏感字段循环引用处理配置DisableCircularReferenceDetect版本安全使用最新稳定版FastJson5.3 最佳实践总结统一序列化策略项目中使用一致的配置文档记录记录团队约定的序列化规则自动化测试添加序列化结果的断言测试性能监控监控关键接口的序列化耗时在实际项目中我建议建立一个统一的JSON处理工具类封装常用的序列化和反序列化方法确保整个项目使用一致的配置。同时对于前后端交互的接口应该明确约定JSON的格式规范避免因为序列化差异导致的问题。对于微服务架构还需要考虑服务间的JSON兼容性特别是当不同服务使用不同版本的FastJson时。可以在网关层或公共库中统一处理JSON的序列化配置确保整个系统的行为一致。