Fastjson 作为Spring Boot 默认json解析器注意点

小灰灰 2021-09-25 02:58 422阅读 0赞

> Fastjson 不多说了，有喜欢的有讨厌的，本项目选址了它，且将Fastjson作为Spring Boot 视图层的默认Json解析器。

## 场景说明 ##

Spring boot 配置默认json解析器如下：

import cn.hutool.core.date.DatePattern;
    import com.alibaba.fastjson.serializer.SerializeConfig;
    import com.alibaba.fastjson.serializer.SerializerFeature;
    import com.alibaba.fastjson.serializer.ToStringSerializer;
    import com.alibaba.fastjson.support.config.FastJsonConfig;
    import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.http.MediaType;
    
    import java.math.BigInteger;
    import java.nio.charset.StandardCharsets;
    import java.util.ArrayList;
    import java.util.List;
    
    /** * @author <a href="mailto:guzhongtao@middol.com">guzhongtao</a> */
    @Configuration
    public class MyFastJsonConfig { 
    
        @Bean
        FastJsonHttpMessageConverter fastJsonHttpMessageConverter() { 
            FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
            List<MediaType> supportedMediaTypes = new ArrayList<>();
            supportedMediaTypes.add(MediaType.TEXT_HTML);
    
    		// .............................注意这一行.............................
    		// 当初不小心将本来在第一个的位置，挪移到了 TEXT_HTML的下面
            supportedMediaTypes.add(MediaType.APPLICATION_JSON);
            
            supportedMediaTypes.add(MediaType.TEXT_XML);
            supportedMediaTypes.add(MediaType.APPLICATION_XML);
            supportedMediaTypes.add(MediaType.APPLICATION_ATOM_XML);
            supportedMediaTypes.add(MediaType.APPLICATION_FORM_URLENCODED);
            supportedMediaTypes.add(MediaType.APPLICATION_OCTET_STREAM);
            supportedMediaTypes.add(MediaType.APPLICATION_PDF);
            supportedMediaTypes.add(MediaType.APPLICATION_RSS_XML);
            supportedMediaTypes.add(MediaType.APPLICATION_XHTML_XML);
            supportedMediaTypes.add(MediaType.IMAGE_GIF);
            supportedMediaTypes.add(MediaType.IMAGE_JPEG);
            supportedMediaTypes.add(MediaType.IMAGE_PNG);
            supportedMediaTypes.add(MediaType.TEXT_EVENT_STREAM);
            supportedMediaTypes.add(MediaType.TEXT_MARKDOWN);
            //supportedMediaTypes.add(MediaType.TEXT_PLAIN);
            converter.setSupportedMediaTypes(supportedMediaTypes);
            FastJsonConfig config = new FastJsonConfig();
            config.setDateFormat(DatePattern.NORM_DATETIME_PATTERN);
            config.setCharset(StandardCharsets.UTF_8);
            config.setSerializerFeatures(
                    SerializerFeature.WriteMapNullValue,
                    SerializerFeature.WriteNullListAsEmpty,
                    SerializerFeature.PrettyFormat,
                    SerializerFeature.WriteNullStringAsEmpty,
                    SerializerFeature.DisableCircularReferenceDetect
            );
            //解决Long转json精度丢失的问题
            SerializeConfig serializeConfig = SerializeConfig.globalInstance;
            serializeConfig.put(BigInteger.class, ToStringSerializer.instance);
            serializeConfig.put(Long.class, ToStringSerializer.instance);
            serializeConfig.put(Long.TYPE, ToStringSerializer.instance);
            config.setSerializeConfig(serializeConfig);
    
            converter.setFastJsonConfig(config);
            return converter;
        }
    }

**某天出现的问题：**  
线上报登录查询出现问题，后来查询问题原因发现 Long类型字段传递到前端精度丢失。

**但！ 我们已经配置了Fastjson里面的 Long类型的策略啊？**

后来又仔细查看，发现返回的结果信息虽然是JSON格式的，但是  
response 设置Header里面的 content-type 值变成了 text/html;charset=UTF-8 导致最后非真正的JSON体返回给浏览器JS解析。

## 注意点 ##

进过仔细debug 源码，理清了思路：

1.  Spring MVC 通过 MediaType 来决定json的解析最终返回文本类型是哪一种
2.  前端通过 Header 里面设置 Accept 来告知 Spring MVC 最终期望的文本类型
3.  如果前端 Header 没有设置 Accept 的值，则默认为 \* / \*
4.  如果 Accept 为 \*/ \* 则最终会选取 FastJsonHttpMessageConverter 中supportedMediaTypes 集合中的第一个作为 最终期望的文本类型

问题原因找到了：

当初不小心把本来在 第一个的 supportedMediaTypes.add(MediaType.APPLICATION\_JSON); 挪移到了下面，且前端从来没有在header里面设置Accept 的值，因此Spring MVC 最后选择了 supportedMediaTypes.add(MediaType.TEXT\_HTML); 作为第一个解析。

## 相关知识点 ##

还是要对Spring MVC 的源码进行深入解读才行

### Spring MVC ###

网上不错的相关文章： [https://www.cnblogs.com/kaiblog/p/7565231.html][https_www.cnblogs.com_kaiblog_p_7565231.html]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70]  
其他还有可以的文章： [https://blog.csdn.net/win7system/article/details/90674757][https_blog.csdn.net_win7system_article_details_90674757]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70 1]

### 消息转换器 HttpMessageConverter ###

SpringMVC 提供了 HttpMessageConverter 接口，用户可以实现接口来转换http请求和响应，比如我们实现请求的序列化和响应的反序列化。

上面的 FastJsonHttpMessageConverter 继承了HttpMessageConverter接口。

[https://www.jianshu.com/p/0aaeb4144489][https_www.jianshu.com_p_0aaeb4144489]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70 2]

[https_www.cnblogs.com_kaiblog_p_7565231.html]: https://www.cnblogs.com/kaiblog/p/7565231.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70]: /images/20210923/c51c913d5fa4495e9ae3adec3c86679b.png
[https_blog.csdn.net_win7system_article_details_90674757]: https://blog.csdn.net/win7system/article/details/90674757
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70 1]: /images/20210923/4ed4146d98344562b26e25171b94baa2.png
[https_www.jianshu.com_p_0aaeb4144489]: https://www.jianshu.com/p/0aaeb4144489
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d6dDE5ODgxMTIz_size_16_color_FFFFFF_t_70 2]: /images/20210923/435b4d6d70b04782bc93ef4d1968744d.png