文章目录

    • 项目背景
    • 问题描述
    • 问题分析
    • 解决方案
      • 方案一：修改Controller定义
      • 方案二：修改Controller返回值
      • 方案三：全局处理

项目背景

Spring Boot 2.X

问题描述

错误信息如下：

org.springframework.http.converter.HttpMessageNotWritableException: No converter for [xxxx] with preset Content-Type 'text/plain;version=0.0.4;charset=utf-8'at org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodProcessor.writeWithMessageConverters(AbstractMessageConverterMethodProcessor.java:312)at org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyMethodProcessor.handleReturnValue(RequestResponseBodyMethodProcessor.java:181)at org.springframework.web.method.support.HandlerMethodReturnValueHandlerComposite.handleReturnValue(HandlerMethodReturnValueHandlerComposite.java:78)at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:124)at org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver.doResolveHandlerMethodException(ExceptionHandlerExceptionResolver.java:428)at org.springframework.web.servlet.handler.AbstractHandlerMethodExceptionResolver.doResolveException(AbstractHandlerMethodExceptionResolver.java:75)at org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver.resolveException(AbstractHandlerExceptionResolver.java:141)at org.springframework.web.servlet.handler.HandlerExceptionResolverComposite.resolveException(HandlerExceptionResolverComposite.java:80)at org.springframework.web.servlet.DispatcherServlet.processHandlerException(DispatcherServlet.java:1323)at org.springframework.web.servlet.DispatcherServlet.processDispatchResult(DispatcherServlet.java:1134)at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1080)at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:963)at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1006)at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:898)at javax.servlet.http.HttpServlet.service(HttpServlet.java:655)at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:883)at javax.servlet.http.HttpServlet.service(HttpServlet.java:764)

问题分析

例如上述错误信息，项目出现了某种异常，并且响应对象设置了响应头，如： Content-Type ‘text/plain;version=0.0.4;charset=utf-8’。
当内部抛出了异常后，项目中的全局异常处理返回了一个通用的实体对象，是JSON格式，和响应头的Content-Type不一致，导致SpringMVC在转换的时候报此类错误。

问题出现场景：

一般出现在，文件下载接口的实现上；
或者，程序内部抛出：ClientAbortException: java.io.IOException: 断开的管道

解决方案

方案一：修改Controller定义

适合场景：返回格式只需兼容的情况

手动指定响应头，设置兼容其它格式，例如：

@PostMapping(value = "xxxx",produces = {MediaType.APPLICATION_OCTET_STREAM_VALUE, MediaType.APPLICATION_JSON_VALUE})

方案二：修改Controller返回值

适合场景：文件下载接口等

解决：原来有返回值的话，修改为返回void。因为文件下载接口，一般是借助HttpServletResponse对象来直接返回的。

方案三：全局处理

解决：在全局异常的处理中，加上下面的逻辑：

@ControllerAdvice@Slf4jpublic class GlobalExceptionHandler {public static final String CLIENT_ABORT_EXCEPTION_CLASS = "org.apache.catalina.connector.ClientAbortException";@ExceptionHandler(Exception.class)public void handleException(Exception e, HttpServletResponse response) {if (CLIENT_ABORT_EXCEPTION_CLASS.equals(e.getClass().getName())) {log.warn("出现ClientAbortException");return;};log.error("全局异常信息：{}", e.getMessage(), e);}}