Spring应用TEXT/PLAIN响应显示\n而非换行的问题排查

我太懂这种糟心的情况了——本地调试时字符串明明是整整齐齐的LINE1、LINE2分行显示，一到Postman里就变成LINE1\nLINE2\n...的混乱样子，肯定是响应的配置或者处理环节出了问题。结合你的控制器场景，给你几个针对性的排查和解决办法：

1. 确保控制器正确设置TEXT/PLAIN响应头 #

很多时候问题出在Content-Type没有明确指定，或者编码设置不对，导致Postman无法正确识别换行符。你可以通过两种方式配置：

方式一：用@RequestMapping的produces属性直接指定 #

在你的请求映射注解里明确声明返回类型和编码：

import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class PlainTextController {

    @GetMapping(value = "/plain-text", produces = MediaType.TEXT_PLAIN_VALUE + ";charset=UTF-8")
    public String getPlainText() {
        // 这里的换行符\n会被正确解析
        return "LINE1\nLINE2\nLINE3";
    }
}

方式二：手动通过HttpServletResponse设置响应头 #

如果需要更灵活的控制，可以直接操作响应对象：

@GetMapping("/plain-text")
public void getPlainText(HttpServletResponse response) throws IOException {
    response.setContentType(MediaType.TEXT_PLAIN_VALUE + ";charset=UTF-8");
    // 直接通过Writer写入内容，换行符会被正确输出
    response.getWriter().write("LINE1\nLINE2\nLINE3");
}

2. 检查Spring的String消息转换器配置 #

Spring默认的StringHttpMessageConverter通常能正确处理纯文本，但如果项目里有自定义的消息转换器配置，可能不小心覆盖了默认行为。你可以显式配置转换器确保编码和换行处理正确：

import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.StringHttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.nio.charset.StandardCharsets;
import java.util.List;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8);
        // 关闭默认的Accept-Charset自动设置，避免编码冲突
        converter.setWriteAcceptCharset(false);
        converters.add(converter);
    }
}

3. 排查Postman的显示设置 #

有时候问题不在后端，而是Postman的显示模式导致的。你可以：

• 切换到Postman响应区域的Raw模式查看原始内容，如果原始内容里是正确的换行（不是\n字符），那只是Postman的Pretty模式解析问题；
• 检查是否开启了“Render HTML”之类的选项，纯文本响应应该关闭这类渲染，让Postman直接按纯文本解析换行。

快速排查步骤 #

1. 先看Postman的响应头，确认Content-Type是text/plain;charset=UTF-8；
2. 切换到Raw模式看响应体，如果显示的是LINE1\nLINE2，说明后端输出的是转义后的换行符，需要检查代码里的字符串生成逻辑；
3. 如果Raw里是正常的分行，那调整Postman的显示模式即可。

内容的提问来源于stack exchange，提问作者hell_storm2004