因为在SpringMVC框架中,使用@RestController(@Controller + @ResponseBody)注解时,响应给前端之前框架会选择一个适当的解析器HttpMessageConverter,将controller中返回的对象解析成指定格式后写入到Response的body中。
Spring有一个在后台注册HttpMessageConverter的列表。HttpMessageConverter的作用是根据预定义的mime(Content-Type)类型将请求体转换成指定的类,然后再转换回请求体。每当触发@ResponseBody注解时,Spring都会遍历这个HttpMessageConverter列表然后选择第一个符合mime类型的转换器和类,然后进行转换。
当controller返回其他类型的时候,框架都会选择MappingJackson2HttpMessageConverter这个解析器将返回值解析成json格式,但当我们返回String时问题就来了。
HttpMessageConverter转换器中还有一个特殊的解析器StringHttpMessageConverter。实际上String类型既可以使用MappingJackson2HttpMessageConverter也可以使用
StringHttpMessageConverter来解析。但是,上面说到了,选择解析器的时候会从列表里选择第一个合适的,而在这个解析器列表中StringHttpMessageConverter的索引又排在MappingJackson2HttpMessageConverter前面,自然就选择到了StringHttpMessageConverter。
那么问题就找到了,当我们在beforeBodyWrite这个方法中做响应体增强的时候,我们返回的是一个具体的对象时,而解析器选择的是StringHttpMessageConverter,对象无法直接转换成String,就导致了转换异常。
解决方法:
写一个配置类,并实现WebMvcConfigurer接口,重写里面的configureMessageConverters方法,将StringHttpMessageConverter从解析器列表中剔除即可。
@Configuration
public class WebResponseConfig implements WebMvcConfigurer {
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
converters.removeIf(e -> e.getClass().isAssignableFrom(StringHttpMessageConverter.class));
}
}