Apache POI 二次运行，已调用workbook.close()仍报Sheet already exists错误

核心根因定位 #

• 磁盘临时文件残留：POI直接读取磁盘File对象构建Workbook时，会持有源文件的系统句柄，Windows环境下文件句柄未完全释放时，File.delete()操作会直接返回false，根本无法完成文件删除。残留的临时文件因为在上次运行时被加载进POI的内存模型，已经附带了新增的Sheet2内容，二次加载时自然触发同名Sheet创建报错。
• 内存实例残留：手动管理Workbook对象生命周期时，容易因为静态引用、全局缓存持有旧的Workbook实例，或是异常中断流程导致Workbook的close方法未被正常调用，造成内存中残留带Sheet2的旧对象，后续流程误引用时就会触发报错。
• 代码逻辑无容错：创建Sheet2时没有做前置存在性校验，只要任何环节读取的Workbook已经包含同名Sheet，就会直接抛出错误，不具备异常场景下的适配能力。

落地修复步骤 #

• 替换手动资源管理逻辑，改用try-with-resources语法管理Workbook生命周期，从根本上避免文件句柄泄漏：
  不要直接传入磁盘File对象给WorkbookFactory.create()，改为从输入流加载模板，出了try代码块后JVM会自动调用Workbook的close方法释放所有关联资源，不会长期持有源文件的系统句柄：

  // 从输入流加载模板，不持有源文件的磁盘句柄
  try (InputStream templateStream = loadTemplateFromLocation(existingTemplateLocation);
       Workbook workbook = WorkbookFactory.create(templateStream)) {
      
      // 前置校验Sheet存在性，从逻辑上阻断报错触发
      Sheet targetSheet = workbook.getSheet("Sheet 2");
      if (targetSheet == null) {
          targetSheet = workbook.createSheet("Sheet 2");
      }
      
      populateWorkbookThenWriteOutToExcel(workbook, someOtherDestinationDifferentFromTemplateLocation);
  }
  

• 修正临时文件清理逻辑，增加删除结果校验与兜底清理：
  原来的file.delete()操作没有校验返回值，一旦因为句柄占用删除失败，后续运行就会一直读到残留的旧文件。修改逻辑为：

  File tempTemplateFile = getFileObjectForExistingXLSXTemplate(existingTemplateLocation);
  // 尝试删除临时文件，失败则注册JVM退出时自动清理
  if (!tempTemplateFile.delete()) {
      tempTemplateFile.deleteOnExit();
  }
  

• 排查常驻进程的缓存逻辑：如果代码运行在Web应用、定时任务等常驻环境，检查是否存在静态变量、全局缓存Map持有了旧的Workbook实例，清理这类强引用，确保每次创建Workbook都是独立的新实例，不会复用内存中残留的旧工作表。

注意：操作过程中不要对源模板文件做写回操作，一旦Sheet2的内容被写入原始模板文件，就算清理了所有句柄，后续每次加载模板都会带着已存在的Sheet2，必须先把模板文件还原成仅包含Sheet1的初始状态。

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