printwriter 仅适用于 utf-8 编码的纯文本文件下载（如 csv、txt），因其基于字符流，写入二进制内容会导致乱码或损坏；正确用法需设置 charset=utf-8 的 content-type、content-disposition，并避免混用 getoutputstream()。
PrintWriter 在 Spring Boot Web 中不适合用于文件下载，尤其是二进制或非纯文本文件（如 Excel、PDF、图片等），它只适用于明确为 UTF-8 编码的纯文本内容导出，且必须严格配合 字符流响应 和正确的 Content-Type 设置。
为什么 PrintWriter 仅限纯文本导出
PrintWriter 是基于字符的输出流，内部会按指定字符编码（如 UTF-8）将字符串转为字节。若用它写入二进制数据（比如 Excel 的 .xlsx 字节流），会导致乱码、截断或文件损坏——因为字符编码器会尝试解析非法字节序列，触发替换或丢弃。
- 适合场景：导出 CSV、TXT、JSON、日志片段等纯文本内容
- 不适用场景：导出 Excel（.xls/.xlsx）、PDF、ZIP、图片、音频等任意二进制格式
- 关键限制：无法控制底层字节写入，不能保证原始字节完整性
正确使用 PrintWriter 导出文本文件
若确认导出内容为纯文本（例如用户列表 CSV），可按以下方式安全使用：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 设置响应头：
response.setContentType("text/csv; charset=UTF-8") - 设置下载提示：
response.setHeader("Content-Disposition", "attachment; filename=\"users.csv\"") - 获取 PrintWriter：
PrintWriter writer = response.getWriter()（注意：不可再调用getOutputStream()） - 逐行写入带 UTF-8 兼容的字符串，例如：
writer.println("姓名,邮箱,注册时间"); - 务必调用
writer.flush()，避免缓冲未写出
更通用、更安全的替代方案
绝大多数导出需求（含文本）推荐统一使用 ServletOutputStream + 字节流，兼顾兼容性与可控性：
- 对文本内容：用
OutputStreamWriter包装，显式指定 UTF-8 编码 - 对二进制内容：直接写入原始字节数组，零转换损耗
- Spring Boot 原生支持：
ResponseEntity<resource></resource>自动处理流、头信息和编码 - 示例：返回
new FileSystemResource(new File("/tmp/report.csv"))即可完成标准下载
常见踩坑提醒
使用 PrintWriter 时容易忽略的关键细节：
- 不能在同一个 HttpServletResponse 中混用
getWriter()和getOutputStream()，否则抛 IllegalStateException - 未设置
charset=UTF-8时，浏览器可能用 ISO-8859-1 解析，中文变乱码 - 大文本未分块写入，可能触发内存溢出；建议配合
BufferedWriter分批 flush - 异常未捕获时，writer 可能未关闭，导致连接挂起或响应不完整
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
