Postman测试REST控制器时CSV/XLS返回内容特殊字符显示异常，但文件生成正常的问题咨询

嘿，这个问题我之前也碰到过！其实核心原因是Postman的预览逻辑和实际文件下载的处理机制不一样，咱们一步步捋清楚：

为什么Postman里会出现大量特殊字符？ #

• 首先，如果你生成的是CSV文件：你设置的编码是ISO-8859-1，但Postman的预览面板默认可能用UTF-8去解析响应内容，编码不匹配就会出现乱码/特殊字符——但实际下载文件时，浏览器或下载工具会严格遵循你在Content-Type里指定的编码去解码，所以文件是正常的。
• 其次，如果生成的是XLS文件：你用了text/csv的Content-Type就错了！XLS是二进制格式的Excel文件，应该用专属的MIME类型，Postman把二进制文件当成文本解析，自然会出现一堆看不懂的特殊字符。

具体解决办法 #

1. 针对CSV文件的优化 #

• 推荐改用UTF-8编码：这是更通用的编码格式，能避免大部分工具的兼容问题，修改后的Header配置：

  headers.set(HttpHeaders.CONTENT_TYPE, "text/csv;charset=UTF-8");
  headers.set(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=" + fileName);
  

  改完后Postman的预览应该就能正常显示内容了。
• 如果必须保留ISO-8859-1：不用纠结Postman的预览，直接点击Postman响应面板里的「Save Response」按钮保存文件，打开后肯定是正常的——因为文件本身的编码是对的，只是Postman预览解析错了。

2. 针对XLS文件的修正 #

XLS文件必须使用正确的MIME类型，把Content-Type改成：

headers.set(HttpHeaders.CONTENT_TYPE, "application/vnd.ms-excel");
headers.set(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=" + fileName);

这样Postman会识别出这是Excel文件，要么直接提示下载，要么用合适的方式预览，不会再出现乱码。

3. Postman临时查看小技巧 #

如果只是想快速验证内容，不用每次都下载：在Postman的响应面板切换到「Raw」标签，然后在编码选择器里选你设置的ISO-8859-1（或者对应编码），就能看到正确的内容了。

总结 #

其实你的控制器逻辑是没问题的——毕竟生成的文件本身是正常的，只是Postman的预览解析规则和实际文件处理的规则不一样。调整下Content-Type或者编码，或者直接用下载文件的方式验证，就能解决这个困扰啦！

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