spring @ResponseBody String 中文乱码(显示问号)

最新推荐文章于 2023-03-30 16:45:35 发布

SineObama

最新推荐文章于 2023-03-30 16:45:35 发布

阅读量1.7k

点赞数

CC 4.0 BY-SA版权

分类专栏： spring 文章标签： spring ResponseBody String 中文编码

本文链接：https://blog.youkuaiyun.com/SineObama/article/details/80064819

spring 专栏收录该内容

0 篇文章

订阅专栏

本文探讨了解决SpringMVC框架中@ResponseBody返回中文时出现乱码的问题。介绍了两种配置方法，一是修改StringHttpMessageConverter的默认编码为UTF-8；二是通过设置支持的content-type类型来覆盖默认编码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

spring @ResponseBody String 中文乱码(显示问号)

根本原因：String默认使用StringHttpMessageConverter转换，而它默认编码是ISO-8859-1。[1]

对StringHttpMessageConverter进行配置可以统一地解决问题。
这里讨论了2种配置方法和2种配置位置，推荐方案在最后。

方法1：修改默认编码。[2]

<bean class="org.springframework.http.converter.StringHttpMessageConverter">
    <constructor-arg value="UTF-8" />
</bean>

如上，通过<constructor-arg value="UTF-8" />指定构造函数的参数，从而设置默认编码。

方法2：添加支持的content-type类型（包含指定编码）。[3]

这里涉及content-type的匹配，网上一些配置是text/plain，但spring默认可能是text/html，这样就匹配不到（比如我的项目中就会导致最终由MappingJackson2HttpMessageConverter来处理）。

如果希望所有String返回值都用该converter处理，可以直接设置*/*匹配所有：

<bean class="org.springframework.http.converter.StringHttpMessageConverter">
    <property name="supportedMediaTypes">
        <list>
            <value>*/*;charset=UTF-8</value>
        </list>
    </property>
</bean>

原理解释

各个转换器根据Controller返回值和content-type判断使用与否。StringHttpMessageConverter只接受String类型，默认匹配text/plain和*/*（相当于匹配所有吧？）。另一方面，如果content-type中没有设置编码，则会使用默认编码。

关于配置位置

位置1：`RequestMappingHandlerAdapter.messageConverters`

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="messageConverters" >
        ...
    </property>
</bean>

这样子配置messageConverters会覆盖原有的转换器（包括项目可能使用的json转换器），而自己再手动加上去就更麻烦了。

而且有个坑的地方：对使用@ExceptionHandler进行异常处理的返回值无效。个人理解是因为RequestMappingHandlerAdapter只处理正常请求，发生异常后由ExceptionHandlerExceptionResolver处理。

位置2：`<mvc:message-converters>`

<mvc:annotation-driven>
    <mvc:message-converters>
        ...
    </mvc:message-converters>
</mvc:annotation-driven>

这样可以给上述2者都加上一个转换器（优先级较高），统一处理正常和异常的情况。

注意：位置1的配置也会覆盖位置2的配置。

最终推荐方案

<mvc:annotation-driven>
    <mvc:message-converters>
        <bean class="org.springframework.http.converter.StringHttpMessageConverter">
            <constructor-arg value="UTF-8" />
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>

其他参考：
Spring Mvc 3.1 之后如何配置messageConverters
SpringMVC-<mvc:annotation-driven>的作用