[SpringMVC] @ResponseBody 返回中文乱码

淡淡的烟草味﹌ 2022-08-18 10:56 233阅读 0赞

参考：[解决SpringMVC的@ResponseBody返回中文乱码][SpringMVC_ResponseBody]

> 原理见: [SpringMVC 中 HTTP 请求与响应原理][SpringMVC _ HTTP]

## 1、现象 ##

--------------------

客户端代码

服务端代码

@RequestMapping(value = "/saveByModel")
        @ResponseBody
        public String saveByModel(@RequestBody Label label) {
            if(this.labelService.update(label) != 0){
                return "更新成功!";
            }
            return "更新标签失败!";
        }

结果：  
![乱码情形][20151212170408779]

## 2、原因 ##

SpringMVC默认处理的字符集是ISO-8859-1。

接口定义为 `@ResponseBody`，使用的返回值处理器为 `RequestResponseBodyMethodProcessor`，使用`HttpMessageConverter` 消息转换机制，会调用对应的 `HttMessageConverter` 处理类。支持 `String` 类型的消息转换器有 `StringHttpMessageConverter, MappingJackson2HttpMessageConverter`。系统默认支持的媒体列表有：

![MediaTypes][]

取得媒体列表后，会选取其中的一个：

![selectMediaType][]

从图中可以看出 `String` 返回值类型取得的媒体类型为 `text/plain;charset=ISO-8859-1`，且使用 `StringHttpMessageConverter` 消息转换类。将该媒体类型设置为 `response` 的 `contentType`, 因此返回中文乱码：

![Content-Type][]

## 3、解决 ##

可修改字符编码，如 springmvc.xml 文件加上如下配置：

<mvc:annotation-driven >
        
        <mvc:message-converters register-defaults="true">
          <bean class="org.springframework.http.converter.StringHttpMessageConverter">
            <property name="supportedMediaTypes" value="text/plain;charset=UTF-8"/>
          </bean>
        </mvc:message-converters>
      </mvc:annotation-driven>

正确结果：  
![正确结果][20151212170531253]

或者指定返回的编码集，如:

@RequestMapping(value = "/save-by-model", method = RequestMethod.POST, produces = "text/plain;charset=utf-8")
    @ResponseBody
    public String saveByModel(@RequestBody Category category) {
        return category.toString();
    }

[SpringMVC_ResponseBody]: http://www.cnblogs.com/netcorner/p/4392693.html
[SpringMVC _ HTTP]: http://blog.csdn.net/u012099869/article/details/78848204
[20151212170408779]: /images/20220731/8a06dc9c40db46ca9f3660403f57bef7.png
[MediaTypes]: /images/20220731/94769bb0bc3948888e47a683e9d505fe.png
[selectMediaType]: /images/20220731/9d2dafec13d3452989b1d7a50126a09d.png
[Content-Type]: /images/20220731/0e689f1332254d1f89560a508e6fb48e.png
[20151212170531253]: /images/20220731/b87c06bb6e594d3e9bccf05889a180f2.png