使用POI 3.16加载11MB XLS文件时如何解决Java堆空间错误？

嘿，这个问题我之前帮同事处理过，POI 3.16处理老式XLS文件的时候内存占用确实有点夸张——11MB的文件看起来不大，但加载时会在内存里膨胀好几倍，很容易触发堆溢出。给你几个实用的解决方案：

1. 先试试调整JVM堆内存参数 #

这是最快见效的方法，直接给JVM分配更多堆空间就行。在启动你的Java程序时，加上这些参数：

-Xms512m -Xmx2048m

• Xms是初始堆内存，设成512MB足够启动；
• Xmx是最大堆内存，2GB对于11MB的XLS来说完全够用，如果你的机器内存充裕，甚至可以设到4GB（-Xmx4096m）。

2. 改用事件驱动的流式解析（彻底解决内存问题） #

如果调了堆内存还是不行，或者不想让程序占用太多内存，那就别用WorkbookFactory.create()这种把整个文件加载到内存的方式了，换成POI的事件驱动解析模式——只处理你需要的内容，不会把整个文档塞进内存。

针对HSSF（.xls格式），可以用HSSFEventFactory和HSSFListener来实现，给你个简单的示例代码：

import org.apache.poi.hssf.eventusermodel.*;
import org.apache.poi.hssf.record.*;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;

import java.io.FileInputStream;

public class XlsStreamParser {
    public static void main(String[] args) throws Exception {
        // 用try-with-resources自动关闭流
        try (FileInputStream fis = new FileInputStream("你的文件路径.xls");
             POIFSFileSystem poifs = new POIFSFileSystem(fis)) {
            
            HSSFRequest request = new HSSFRequest();
            // 添加一个监听器处理所有记录
            request.addListenerForAllRecords(new HSSFListener() {
                @Override
                public void processRecord(Record record) {
                    // 按需处理不同类型的记录，比如行记录、单元格记录
                    if (record instanceof RowRecord) {
                        RowRecord row = (RowRecord) record;
                        System.out.println("当前处理行号: " + row.getRowNumber());
                    } else if (record instanceof NumberRecord) {
                        NumberRecord numCell = (NumberRecord) record;
                        System.out.println("数字单元格：列" + numCell.getColumn() + "，值：" + numCell.getValue());
                    }
                    // 字符串单元格用LabelRecord，公式用FormulaRecord，按需添加处理逻辑
                }
            });
            
            HSSFEventFactory eventFactory = new HSSFEventFactory();
            eventFactory.processWorkbookEvents(request, poifs);
        }
    }
}

这种方式内存占用极低，不管多大的XLS文件都能处理，就是需要你自己编写对应记录的处理逻辑，适合只需要读取特定数据的场景。

3. 升级POI版本（长期最优解） #

POI 3.16是2017年的老版本了，后续的4.x、5.x版本对内存管理做了大量优化，尤其是HSSF的内存使用效率提升明显，升级后很多时候不用改代码，直接用WorkbookFactory.create()就能加载成功。

不过升级时要注意兼容性：比如POI 4.x开始要求Java 8+，5.x要求Java 11+，一些内部API可能有变动，但WorkbookFactory这类核心API的用法基本没变，迁移成本不高。

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