解决：No converter for [xxxx] with preset Content-Type ‘text/plain；version=0.0.4；charset=utf-8‘

小咪咪 2024-03-24 09:32 12阅读 0赞

#### 文章目录 ####

*   *  项目背景
     *  问题描述
     *  问题分析
     *  解决方案
     *   *  方案一：修改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
    @Slf4j
    public 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);
        }
    
    }