HttpServletResponse通过setContentType设置响应头失败，以及解决办法

最新推荐文章于 2025-09-10 20:51:49 发布

原创最新推荐文章于 2025-09-10 20:51:49 发布 · 7.6k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#java

Bug 专栏收录该内容

11 篇文章

订阅专栏

本文介绍了一个在Spring Cloud Dalston.SR1版本中，使用Spring Boot 1.5.3.Release时遇到的问题，即从Controller直接返回JSON字符串时，content-type被错误地设置为text/plain。文中提供了解决方案，即通过设置@RequestMapping的produces属性来修正content-type。

1 背景

1.1 版本信息

springcloud版本：Dalston.SR1
springboot版本：1.5.3.Release
JDK版本：1.8

1.2 缺陷描述

当我从Controller或者ControllerAdvice直接返回一个JSON字符串时，通过response.setContentType("application/json;charset=UTF-8");失败，前端实际拿到的content-type为text/plain;charset=UTF-8.如果前端对头部有校验的话，很可能会出现拿不到数据的情况.以下为示例代码，当调用/fail接口就可以看到结果

全局异常处理类

@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    @ExceptionHandler(value = {Exception.class})
    @ResponseStatus(value = HttpStatus.OK)
    @ResponseBody
    public Object defaultHandler(HttpServletResponse response,Exception e) throws JsonProcessingException {
        log.error(e.getMessage(),e);
        response.setContentType("application/json;charset=UTF-8");
        if(e instanceof PSQLException
                || e instanceof PersistenceException
                || e instanceof MyBatisSystemException
                || e instanceof BadSqlGrammarException){
            return  ResultObject.exception(1,"内部错误:数据库操作失败");
        }

        if(e instanceof HttpHostConnectException
                || e instanceof RetryableException){
            return ResultObject.exception(1,"连接失败:请检查第三方系统接入状态");
        }

        return "{\n" +
                "  \"code\": 1,\n" +
                "  \"msg\": \"未知错误,请联系管理员\"\n" +
                "}";
    }

}

controller层代码

@Api(value = "测试", tags = "测试")
@RequestMapping("/test")
@RestController
public class TestController {

    @GetMapping(value = "/fail")
    @ApiOperation("失败")
    public String fail() {
        int i=1/0;
        return "fail";
    }

  
}