使用Apache Poi生成Excel遇问题：格式无效、文件锁定及前端下载咨询

问题代码 #

public void createfile(Request request, Response response) throws Exception {
try {
        Integer id = ParamUtils.getParamInt(request, "id", null);
        Workbook workbook = new HSSFWorkbook();
        Sheet sheet = workbook.createSheet("new sheet");
        FileOutputStream fileOut = new FileOutputStream("workbook.xls");
        workbook.write(fileOut);
        fileOut.close();
        }
        catch (IncorrectData e) {
            return e;
        }
    }

问题1：打开文件提示“格式或扩展名无效” #

• 原因：HSSFWorkbook对应旧版Excel格式（.xls），但如果写入过程中断、文件未完整生成，或者服务器路径权限不足导致写入失败，都会触发该提示。
• 修复方案：
  1. 使用try-with-resources自动管理流，确保写入完成后安全释放资源，避免手动关闭遗漏：

     try (FileOutputStream fileOut = new FileOutputStream("workbook.xls")) {
         workbook.write(fileOut);
     } // 流会自动关闭，无需手动调用close()
     

  2. 检查生成文件的大小，空HSSFWorkbook生成的.xls文件至少有几KB，若文件大小为0则说明写入未完成，需排查路径权限或代码异常。

问题2：已关闭OutputStream仍提示“文件被其他用户锁定” #

• 原因：
  1. 若workbook.write(fileOut)抛出异常，会直接进入catch块，跳过fileOut.close()，导致流未释放、文件被锁定；
  2. 服务器上的杀毒软件、文件监控进程可能会扫描新生成的文件，暂时占用资源。
• 修复方案：
  1. 强制用try-with-resources语法管理流，同时主动关闭Workbook释放内部资源：

     Workbook workbook = new HSSFWorkbook();
     Sheet sheet = workbook.createSheet("new sheet");
     try (FileOutputStream fileOut = new FileOutputStream("workbook.xls")) {
         workbook.write(fileOut);
     } catch (IncorrectData e) {
         // 异常处理逻辑
     } finally {
         workbook.close();
     }
     

  2. 选择服务器上非系统监控目录生成文件，确保目录读写权限充足。

问题3：服务器生成的Excel能否返回给前端下载？ #

完全可以，无需在服务器本地生成物理文件，直接将Workbook写入Response输出流即可，步骤如下：

1. 设置Response响应头，指定文件类型和下载文件名：

   response.setContentType("application/vnd.ms-excel");
   response.setHeader("Content-Disposition", "attachment; filename=\"download.xls\"");
   

2. 将Workbook写入Response输出流：

   try (ServletOutputStream out = response.getOutputStream()) {
       workbook.write(out);
       out.flush();
   } finally {
       workbook.close();
   }
   

3. 移除本地文件生成代码，避免磁盘占用和文件锁定问题。

内容的提问来源于stack exchange，提问作者Miss.Q