Apache Fesod：告别Excel处理的内存噩梦，让百万行数据读写不再OOM-开发者社区

Apache Fesod：告别Excel处理的内存噩梦，让百万行数据读写不再OOM

【免费下载链接】fesodFast. Easy. Done. Processing spreadsheets without worrying about large files causing OOM.项目地址: https://gitcode.com/gh_mirrors/fast/fesod

凌晨两点，你的服务突然告警。日志里躺着一行刺眼的OutOfMemoryError——导出报表的功能又崩了。原因很熟悉：用户上传了一个50万行的Excel文件，你的代码用传统POI方式一次性把整个工作簿加载进内存，JVM直接躺平。这不是技术能力问题，而是处理思路的问题。

有没有一种方案，能让你像处理普通列表一样处理超大Excel，内存却稳如老狗？答案就是今天的主角：Apache Fesod（Incubating）——一个专为大规模电子表格处理而生的高性能Java库。它的口号只有三个词：Fast. Easy. Done.，处理电子表格时完全不用担心大文件导致OOM。

核心能力剖析：为什么它能让你安心处理百万行数据

Fesod之所以敢承诺"不OOM"，靠的是三大硬核能力。我们逐一看它如何做到。

⚡ 流式读取（Streaming Read）：把"整本搬进内存"变成"逐行流过"

为什么重要：传统方式读取Excel，是把整个文件解析成内存对象树，文件多大，内存就要多大。百万行数据，直接压垮默认堆内存。

怎么做到：Fesod采用SAX模式流式解析，逐行读取、逐行回调，读完即弃。配合内置的分页监听器PageReadListener，每批处理100行数据，你可以在此处批量入库或落盘：

// 三步完成流式读取：指定文件、数据模型、监听器 FesodSheet.read("百万行.xlsx", DemoData.class, new PageReadListener<>(dataList -> { // 每100行回调一次，批量处理，内存只保留100行的量 for (DemoData data : dataList) { log.info("读取到一行：{}", JSON.toJSONString(data)); } })).sheet().doRead(); // 资源自动释放

效果如何：无论文件是10MB还是2GB，你的应用内存占用几乎是一条平稳的直线。这正是金融对账、日志分析这类场景最需要的安全感。

🔄 模板填充（Template Fill）：让复杂报表"按图施工"

为什么重要：业务报表往往有固定版式——标题、汇总区、明细区。手动写代码拼单元格既繁琐又易错。

怎么做到：Fesod支持基于模板的填充。在模板里用{name}、{.name}占位符标记填充位置，一个.前缀就能让该单元格随列表逐行重复：

// 用模板文件 + 占位符生成报表 FesodSheet.write("月度报表.xlsx") .withTemplate("模板.xlsx") .sheet() .doFill(fillDataList); // {.name} 会自动逐行展开

效果如何：模板里预留的样式、合并单元格、Logo全部保留，代码却只有几行。改版式只改模板，不动代码。

🎨 注解驱动的合并与样式：专业报表唾手可得

为什么重要：明细数据中重复的分类名需要合并单元格，头行需要样式，这些"看起来不起眼、做起来很麻烦"的细节最消耗工时。

怎么做到：一行注解即可实现循环合并，样式支持字体、边框、背景色全覆盖：

public class DemoMergeData { @ContentLoopMerge(eachRow = 2) // 每两行合并一次 @ExcelProperty("分类") private String string; // ... }

效果如何：原本几十行的合并逻辑，压缩成一行注解。报表的美观度和代码的简洁度同时达标。

进阶玩法：几个不为人知却极度好用的隐藏技巧

基础能力已经够强，但Fesod的"隐藏彩蛋"才是拉开差距的地方。

🧩 一表多列表格填充：一个模板装下三个数据源

普通填充只能填一个列表，而Fesod支持多个列表同时填充，通过FillWrapper给每个列表命名，模板中用{data1.name}精确指定数据来源。更妙的是，不同列表还可以指定不同填充方向——一个横向铺开，两个纵向堆叠，互不干扰：

writer.fill(new FillWrapper("data1", data()), FillConfig.builder().direction(WriteDirectionEnum.HORIZONTAL).build(), writeSheet); writer.fill(new FillWrapper("data2", data()), writeSheet); writer.fill(new FillWrapper("data3", data()), writeSheet);

实用场景：一张报表同时展示"TOP10排行（横排）"和"明细清单（竖排）"，一行代码搞定。

🔧 自定义转换器：任何数据类型都能"听懂"Excel

遇到LocalDateTime、自定义枚举、甚至URL图片？Fesod的转换器体系（Converter接口）允许你接管读写双向转换，日期格式、金额精度都能按业务规则定制。写图片时，文件、输入流、字节数组、URL四种数据源随意切换——报表里嵌图、嵌二维码都是基操。

📦 大文件写入的压缩黑科技

写超大数据时，POI的SXSSF流式API会把临时XML写到磁盘，磁盘紧张怎么办？Fesod支持压缩临时文件，用少量CPU换大量磁盘空间。配合ExcelWriter分批写入，100万行数据也游刃有余。

落地实践指南：从零跑通你的第一个Fesod案例

理论说了一堆，不如动手跑一遍。跟着下面四步，十分钟内出第一个Excel。

第一步：引入依赖（Maven 示例，最新版本以官方为准）

<dependency> <groupId>org.apache.fesod</groupId> <artifactId>fesod-sheet</artifactId> <version>2.0.2-incubating</version> </dependency>

第二步：定义数据模型——用@ExcelProperty把Java字段映射到表头：

public class DemoData { @ExcelProperty("字符串列") private String string; @ExcelProperty("日期列") private Date date; @ExcelIgnore // 此字段不参与读写 private String ignore; }

第三步：写代码——读和写各只需一行核心调用：

// 写入：生成带表头的Excel FesodSheet.write("输出.xlsx", DemoData.class).sheet("模板").doWrite(dataList); // 读取：流式解析并逐行打印 FesodSheet.read("输入.xlsx", DemoData.class, new PageReadListener<>(list -> {})).sheet().doRead();

第四步：验证结果——打开生成的Excel检查表头、日期格式和数据类型是否与预期一致；读取时观察日志，确认每行数据都正确回调。

小贴士：小数据量快速预览可以用doReadSync()一次性读入内存列表；大数据量务必走流式监听器。

想要更系统的学习？官方文档覆盖了读取、写入、填充、样式、CSV、Spring集成等全部场景，仓库中的fesod-examples模块提供了每个特性的可运行示例代码，是绝佳的学习素材。

价值总结与行动号召

回到开头的那个凌晨。如果用Fesod重写那次导出，结论会完全不同：内存占用可降低约80%，读取性能提升数倍，代码量缩减一半以上。它继承了Alibaba EasyExcel的成熟基因，又经过Apache孵化器的严苛打磨——JDK8到JDK25全兼容，流式读写、模板填充、注解样式、自定义转换器一应俱全。

读完这篇文章，你收获了：