使用Apache POI生成Excel遇异常：文件被Java进程占用且写入失败

1. 修正流操作顺序与资源管理 #

必须严格遵循写入流→刷新流→关闭流→关闭Workbook的顺序，推荐用JDK的try-with-resources语法自动管理资源，避免手动关闭出错：

try (FileOutputStream fos = new FileOutputStream("test.xlsx");
     XSSFWorkbook workbook = new XSSFWorkbook()) {
    // 核心数据写入逻辑
    XSSFSheet sheet = workbook.createSheet("测试表");
    XSSFRow row = sheet.createRow(0);
    row.createCell(0).setCellValue("测试内容");
    
    // 先将Workbook写入流，再刷新
    workbook.write(fos);
    fos.flush();
} catch (IOException e) {
    e.printStackTrace();
}

错误示例（会导致0字节文件）：先关闭Workbook再关闭流，此时Workbook已释放资源，流无法写入数据。

2. 检查文件路径与权限 #

• 优先使用绝对路径生成文件，避免因相对路径导致文件生成在非预期目录（比如项目根目录而非你指定的路径），误以为当前文件是0字节。
• 确认程序对目标目录有写入权限，无权限时POI不会抛出明确异常，但会直接导致写入失败。

3. 排查数据写入逻辑 #

• 检查创建Sheet、Row、Cell的代码是否被条件分支跳过（比如判断条件不成立，导致根本没生成数据结构）。
• 仅创建Workbook而不创建Sheet/Row/Cell的话，生成的文件会被识别为无效格式，打开后显示为空表格。

4. 统一依赖版本 #

确保Apache POI相关依赖版本一致，避免混合不同版本导致兼容性问题：

<!-- 示例使用5.2.5版本，保持poi与poi-ooxml版本统一 -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.5</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>

建议搭配JDK8及以上版本使用POI 4.x或5.x，低版本POI对高JDK兼容性较差。

5. 文件占用问题处理 #

• 确认没有其他线程同时操作目标文件，try-with-resources会自动关闭资源，避免手动关闭遗漏导致进程占用。
• 若文件仍被Java进程占用，可通过任务管理器结束对应Java进程后再打开文件。

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