使用HttpServletResponse下载Excel后二次下载失效问题求助

问题根源 #

你遇到的二次下载失效，核心原因是**workbook被声明为类成员变量**：首次执行workbook.write(outputStream)时，POI库会自动关闭workbook资源；第二次调用方法时，workbook已经处于关闭状态，无法再写入数据。

修复方案 #

1. 每次下载新建Workbook实例 #

将Workbook的创建移到DatosaExcel方法内部，确保每次下载都使用全新的工作簿，避免复用已关闭的实例。同时修改writeHeaderLine和writeDataLines方法，让它们接收传入的Workbook作为参数，而非操作全局变量。

修改后的业务方法代码：

public void DatosaExcel(HttpServletResponse response) throws IOException {
    // 每次调用都创建新的Workbook实例
    Workbook workbook = new XSSFWorkbook(); // 生成.xlsx用XSSF，.xls用HSSF
    try (ServletOutputStream outputStream = response.getOutputStream()) {
        // 传入新创建的workbook进行表头和数据写入
        writeHeaderLine(workbook);
        writeDataLines(workbook);
        
        workbook.write(outputStream);
    } finally {
        workbook.close();
    }
}

2. 优化Controller响应配置 #

补充字符编码、禁止缓存的响应头，避免浏览器复用旧响应或文件名乱码：

@GetMapping("/DescargarExcelEmpleados")
public void DescargarEmpleados(HttpServletResponse response) throws IOException {
    // 针对xlsx文件设置正确的Content-Type
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setCharacterEncoding("UTF-8");
    
    // 处理中文文件名乱码
    String fileName = URLEncoder.encode("empleados.xlsx", "UTF-8");
    response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");
    
    // 设置禁止缓存，避免浏览器复用旧响应
    response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
    response.setHeader("Pragma", "no-cache");
    response.setHeader("Expires", "0");
    
    productService.DatosaExcel(response);
}

3. 简化资源管理（可选） #

如果使用JDK 7及以上版本，推荐用try-with-resources自动管理Workbook和输出流，无需手动关闭：

public void DatosaExcel(HttpServletResponse response) throws IOException {
    try (Workbook workbook = new XSSFWorkbook();
         ServletOutputStream outputStream = response.getOutputStream()) {
        writeHeaderLine(workbook);
        writeDataLines(workbook);
        workbook.write(outputStream);
    }
}

关键注意事项 #

• 禁止将Workbook、Sheet等POI核心对象声明为类成员变量，它们并非线程安全，且使用后会被自动关闭，无法重复利用。
• 确保writeHeaderLine和writeDataLines方法内部操作的是传入的Workbook实例，而非全局变量。

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