解决SpringMvc后台接收json数据中文乱码问题的几种方法

以下是解决SpringMvc后台接收json数据中文乱码问题的几种方法的完整攻略。

问题描述

在使用SpringMvc后台接收json数据时，如果json数据中包含中文字符，很可能会出现中文乱码的情况。这是因为在数据传输过程中，中文字符会被转换为字节流，而接收端没有正确解析字节流，导致中文乱码的问题。针对这个问题，我们可以采用以下几种方法进行解决。

方法一：在WebMvcConfigurer中配置HttpMessageConverter

该方法的实现步骤如下：

创建一个WebMvcConfigurer的实现类，并重写该接口的configureMessageConverters方法。

@Configuration
public class MyWebMvcConfigurer implements WebMvcConfigurer {

  @Override
  public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
    converter.setDefaultCharset(Charset.forName("UTF-8"));
    converters.add(converter);
  }

}

在Spring配置文件中进行配置，将上一步创建的WebMvcConfigurer实现类注册到Spring容器中。

@Configuration
public class AppConfig {

  @Bean
  public MyWebMvcConfigurer myWebMvcConfigurer() {
    return new MyWebMvcConfigurer();
  }

}

上述代码中，我们使用了FastJsonHttpMessageConverter来处理请求消息，设置其默认字符集为UTF-8，从而解决中文乱码问题。

方法二：使用过滤器Filter进行编码转换

该方法的实现步骤如下：

创建一个编码过滤器，代码如下：

public class EncodingFilter implements Filter {

  private String encoding;

  public void init(FilterConfig config) throws ServletException {
    encoding = config.getInitParameter("encoding");
  }

  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException {
    request.setCharacterEncoding(encoding);
    chain.doFilter(request, response);
  }

  public void destroy() {

  }

}

在Spring配置文件中进行配置，将上一步创建的编码过滤器注册到Spring容器中。

@Configuration
public class AppConfig {

  @Bean
  public EncodingFilter encodingFilter() {
    EncodingFilter filter = new EncodingFilter();
    filter.setEncoding("UTF-8");
    return filter;
  }

  @Bean
  public FilterRegistrationBean<EncodingFilter> encodingFilterRegistration() {
    FilterRegistrationBean<EncodingFilter> registration = new FilterRegistrationBean<>();
    registration.setFilter(encodingFilter());
    registration.addUrlPatterns("/*");
    registration.setName("EncodingFilter");
    registration.setOrder(1);
    return registration;
  }

}

上述代码中，我们注册了一个名称为“EncodingFilter”的过滤器，将其映射到所有的请求路径上，并将字符集设置为UTF-8。

示例说明

为了验证上述两种方法的效果，我们可以编写一个简单的RESTful接口，接收包含中文字符的json数据，并将其返回，以此验证是否存在中文乱码的问题。

首先，我们创建一个RestController类并定义一个接口。

@RestController
public class TestController {

  @PostMapping("/test")
  public Map<String, String> test(@RequestBody Map<String, String> request) {
    return request;
  }

}

接着，我们可以使用Postman工具发送一条请求，请求的json数据包含中文字符。

POST /test HTTP/1.1
Host: localhost:8080
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache
Postman-Token: d485f997-5f47-4f35-b234-8564cc4a523f

{
  "name": "张三",
  "age": 18
}

如果使用上述的两种方法进行了配置，则我们可以收到如下响应：