SpringBoot下载PDF无法打开且文件体积变小问题求助

可能的问题点及对应解决方案 #

1. 输出流未刷新/数据未完全写入 #

IOUtils.copy执行后，若未刷新输出流，部分缓存数据可能无法完整写入响应，导致文件截断。修改代码如下：

filename = pdf_location + filename + ".pdf";
try (BufferedInputStream inputStream = new BufferedInputStream(new FileInputStream(filename))) {
    OutputStream out = response.getOutputStream();
    IOUtils.copy(inputStream, out);
    out.flush(); // 强制刷新输出流，确保所有二进制数据发送至客户端
} catch (IOException e) {
    // 这里可添加日志记录或错误响应逻辑
    e.printStackTrace();
}

使用try-with-resources语法自动关闭输入流，避免资源泄漏。

2. 未设置Content-Length响应头 #

浏览器若无法获取文件准确大小，可能提前截断数据。添加文件长度头，并处理文件名编码（避免中文乱码）：

File pdfFile = new File(filename);
response.setContentLengthLong(pdfFile.length()); // 告知浏览器文件实际大小
response.setContentType("application/pdf");
// 编码文件名，避免中文或特殊字符导致的下载异常
response.addHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(fileName + ".pdf", "UTF-8"));

3. 确认输出流类型正确 #

PDF是二进制文件，必须使用OutputStream传输，禁止使用Writer（会对二进制数据转码破坏文件结构）。确保你获取的是response.getOutputStream()而非response.getWriter()。

4. 校验文件路径与原文件完整性 #

打印文件路径和原文件大小，确认读取的是目标文件：

File pdfFile = new File(filename);
System.out.println("读取文件路径：" + pdfFile.getAbsolutePath());
System.out.println("原文件大小：" + pdfFile.length());

若打印的文件大小与实际原文件不符，说明路径拼接错误，读取到了错误文件。

5. 排除Swagger/knife4j的干扰 #

虽然浏览器访问也出现问题，可临时关闭Swagger相关配置，直接测试原生接口。部分API文档工具在处理二进制响应时可能存在兼容问题，也可尝试去掉接口上的produces = "application/pdf"，让Spring自动推断响应类型。

快速验证方法 #

• 对比原文件与下载后文件的大小，若差异明显，说明数据未完整传输
• 用文本编辑器打开下载后的PDF，检查开头是否为PDF标准标识%PDF-，若缺失或乱码，说明数据流被破坏

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