Springboot 2.x 踩坑

springboot1.x 时期我们需要手动编写characterEncodingFilter,通常这么做:

   @Bean
    public Filter characterEncodingFilter() {
        CharacterEncodingFilter characterEncodingFilter = new CharacterEncodingFilter();
        characterEncodingFilter.setEncoding("UTF-8");
        characterEncodingFilter.setForceEncoding(true);
        return characterEncodingFilter;
    }

这个没问题, 只要我们编辑器以及数据编码都是UTF-8, 中文就不会出现乱码。

最近刚接手了别人的代码, 代码使用的springboot2.x(截止目前官方已经更新到2.4.5版本), 随便测了下发现了接口返回乱码,编码出了问题,看了代码没有发现任何 CharacterEncodingFilter 相关代码,这是因为 springboot2 把常用的characterEncodingFilter功能通过HttpEncodingAutoConfiguration做了自动配置,部分源码如下:

    public boolean shouldForce(Type type) {
      Boolean force = (type != Type.REQUEST) ? this.forceResponse : this.forceRequest;
      if (force == null) {
        force = this.force;
      }
      if (force == null) {
        force = (type == Type.REQUEST);
      }
      return force;
    }

注意代码: 如果没有设置spring.http.encoding.force属性,springboot会只对请求的数据进行强制字符集过滤,找到了问题,解决思路也就有了,在你的项目配置文件中添加如下配置:

spring:
  http:
    encoding:
      charset: UTF-8
      enabled: true
      force: true

再次测试ok,乱码问题解决。

总结:

  • springboot 基于约定大于配置的思想,随着版本的迭代,把很多常用的东西都做成了自动配置,但是同时也留下了不少的坑。
  • 查找问题一定要刨根问底。


如果觉得还不错的话,关注、分享、在看, 原创不易,且看且珍惜~

posted on 2021-07-25 14:48  XuHe1  阅读(49)  评论(0编辑  收藏  举报