try-with-resources是否会自动调用dispose()方法？

核心结论 #

默认情况下，try-with-resources 只会自动调用实现了 AutoCloseable（或其子接口 Closeable）的资源的 close() 方法，不会触发 dispose()。

原因说明 #

try-with-resources 的底层逻辑是：当资源类实现 AutoCloseable 接口时，代码块执行完毕后会自动调用该接口定义的 close() 方法。而 POI 中 Workbook 的 dispose() 是独立于 AutoCloseable 之外的自定义方法，不属于接口约定范围，因此不会被 try-with-resources 自动调用。

解决方案 #

根据你使用的 POI 版本，有两种处理方式：

• 如果使用 POI 3.17 及以上版本：
  新版本的 XSSFWorkbook 中，close() 方法内部已经集成了 dispose() 的逻辑，调用 close() 就会自动完成资源清理（包括堆外内存释放）。此时直接使用 try-with-resources 即可，无需额外调用 dispose()：

  try (Workbook workbook = new XSSFWorkbook(new FileInputStream("large_excel.xlsx"))) {
      // 处理 Excel 文件的业务逻辑
  } catch (IOException e) {
      // 异常处理逻辑
  }
  

• 如果使用 POI 3.17 以下版本：
  旧版本的 close() 不会自动调用 dispose()，需要手动在 try 块内完成调用，或者自定义包装类统一处理：

  1. 手动调用方式：

  try (Workbook workbook = new XSSFWorkbook(new FileInputStream("large_excel.xlsx"))) {
      // 处理 Excel 文件的业务逻辑
      workbook.dispose(); // 手动释放堆外内存资源
  } catch (IOException e) {
      // 异常处理逻辑
  }
  

  2. 自定义包装类方式（适合多处复用场景）：

  class AutoDisposeWorkbook implements AutoCloseable {
      private final Workbook target;
  
      public AutoDisposeWorkbook(Workbook target) {
          this.target = target;
      }
  
      public Workbook get() {
          return target;
      }
  
      @Override
      public void close() throws Exception {
          target.dispose();
          target.close();
      }
  }
  
  // 使用示例
  try (AutoDisposeWorkbook wrapper = new AutoDisposeWorkbook(new XSSFWorkbook("large_excel.xlsx"))) {
      Workbook workbook = wrapper.get();
      // 处理 Excel 文件的业务逻辑
  } catch (Exception e) {
      // 异常处理逻辑
  }
  

补充说明 #

POI 的 dispose() 主要用于清理处理大型 Excel 时产生的堆外内存资源（比如 XSSF 依赖的 OOXML 解析器占用的非堆内存），这些资源无法通过 JVM 垃圾回收自动释放，因此必须确保调用该方法以避免内存泄漏。

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