Spring @responsebody返回json字符串乱码 or 请求406

最新推荐文章于 2024-10-11 09:02:58 发布

原创最新推荐文章于 2024-10-11 09:02:58 发布 · 809 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#spring #json #乱码

本文详细解析了Spring MVC中返回JSON字符串时出现乱码的原因，主要是由于StringHttpMessageConverter默认编码为ISO-8859-1导致。文章提供了通过配置文件自定义StringHttpMessageConverter及其支持的媒体类型来解决该问题的方法。

由于项目中每个人喜欢返回的东西不一样，有的人返回json字符串，有的就直接@response注解返回对应的类型。但是Spring对字符串转换和对象转换使用不同转换器。String转换器，默认转换编码ISO-8859-1,
对象转换器默认转编码utf-8。
出现http响应吗406，一种可能是我们没有配置对象转换器，还有可能就是缺少了对应的转换的jackson包。启用
@Responsebody注解将采用默认的转换器。

/**
     * Adds a set of default HttpMessageConverter instances to the given list.
     * Subclasses can call this method from {@link #configureMessageConverters(List)}.
     * @param messageConverters the list to add the default message converters to
     */
    protected final void addDefaultHttpMessageConverters(List<HttpMessageConverter<?>> messageConverters) {
        StringHttpMessageConverter stringConverter = new StringHttpMessageConverter();
        stringConverter.setWriteAcceptCharset(false);

        messageConverters.add(new ByteArrayHttpMessageConverter());
        messageConverters.add(stringConverter);
        messageConverters.add(new ResourceHttpMessageConverter());
        messageConverters.add(new SourceHttpMessageConverter<Source>());
        messageConverters.add(new AllEncompassingFormHttpMessageConverter());
        if (romePresent) {
            messageConverters.add(new AtomFeedHttpMessageConverter());
            messageConverters.add(new RssChannelHttpMessageConverter());
        }
        if (jaxb2Present) {
            messageConverters.add(new Jaxb2RootElementHttpMessageConverter());
        }
        if (jackson2Present) {
            messageConverters.add(new MappingJackson2HttpMessageConverter());
        }
        else if (jacksonPresent) {
            messageConverters.add(new MappingJacksonHttpMessageConverter());
        }
    }

查看源码发现启用注解有很多类型的转换器。StringHttpMessageConverter类型的转换器默认编码

StringHttpMessageConverter
所以当返回String类型的json字符串，只启用注解的话就会乱码。

解决方法

在配置文件中配置StringHttpMessageConverter

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
            <list>
                <bean
                    class="org.springframework.http.converter.StringHttpMessageConverter">
                    <property name="supportedMediaTypes">
                        <list>
                            <value>application/json;charset=UTF-8</value>
                            <value>text/plain;charset=UTF-8 </value>
                        </list>
                    </property>
                </bean>
            </list>
        </property>
    </bean>

注解必须放在配置之后。否则启用的还是默认的转换器。如果你还想配置对象转换器还需要在加MappingJacksonHttpMessageConverter

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
            <list>
                <bean
                    class="org.springframework.http.converter.StringHttpMessageConverter">
                    <property name="supportedMediaTypes">
                        <list>
                            <value>application/json;charset=UTF-8</value>
                            <value>text/plain;charset=UTF-8 </value>
                        </list>
                    </property>
                </bean>
                <bean id="mappingJacksonHttpMessageConverter"
                    class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
                    <property name="supportedMediaTypes">
                        <list>
                            <value>application/json;charset=UTF-8</value>
                        </list>
                    </property>
                </bean>
            </list>
        </property>
    </bean>