EasyExcel 凉了？FastExcel 又“改名“了？这次它进了 Apache，再不会跑了！

这是一个或许对你有用的社群 一对一交流/面试小册/简历优化/求职解惑欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料《项目实战视频》从书中学往事上“练”《互联网高频面试题》面朝简历学习春暖花开《架构 x 系统设计》摧枯拉朽掌控面试高频场景题《精进 Java 学习指南》系统学习互联网主流技术栈《必读 Java 源码专栏》知其然知其所以然这是一个或许对你有用的开源项目国产Star破10w的开源项目前端包括管理后台、微信小程序后端支持单体、微服务架构RBAC权限、数据权限、SaaS多租户、商城、支付、工作流、大屏报表、ERP、CRM、AI大模型、IoT物联网等功能多模块https://gitee.com/zhijiantianya/ruoyi-vue-pro微服务https://gitee.com/zhijiantianya/yudao-cloud视频教程https://doc.iocoder.cn【国内首批】支持 JDK17/21SpringBoot3、JDK8/11Spring Boot2双版本来源一年三连跳EasyExcel → FastExcel → Apache Fesod横向对比5 个 Excel 处理方案怎么选3 个研发场景什么时候它顶用接入 3 步依赖 实体类 监听器核心 API写、读、转 PDF迁移指南从 EasyExcel / FastExcel 切到 Fesod4 个真实使用边界我的判断一年三连跳EasyExcel → FastExcel → Apache FesodJava 圈最常用的 Excel 库过去一年完成了一次罕见的「三连跳」2024 年底阿里官宣EasyExcel 不再维护——5 年的头牌库进入「祝它好运」状态2024-2025原作者离开阿里后推出FastExcel——API 完全兼容主打「换 import 就能切」2025-2026FastExcel再次消失——原作者把项目整套捐给了 Apache 软件基金会更名为Apache Fesod (Incubating)。最新版本2.0.1-incubating已于 2026-02-11 发布。很多人一脸懵——「上次刚换完 import怎么又没了」别紧张这次不是停更是升级到 Apache 一级开源项目——代码所有权从个人 / 公司转给基金会长期维护、版本节奏跟 Apache POI、Maven、Tomcat 一个待遇。这是开源项目能拿到的最好结局。说白了它不是「比 FastExcel 更强的另一个轮子」是「FastExcel 拿到了 Apache 终身保障」——对存量项目是迁移成本最低、最值得切的接班选项。基于 Spring Boot MyBatis Plus Vue Element 实现的后台管理系统 用户小程序支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能项目地址https://github.com/YunaiV/ruoyi-vue-pro视频教程https://doc.iocoder.cn/video/横向对比5 个 Excel 处理方案怎么选把过去 5 年常见的 5 个方案放一张表差距一目了然方案维护状态适用规模内存模型致命短板Apache POI活跃任意DOM重十万行级写入容易 OOMPOI SXSSF活跃大文件流式写还行读不擅长HuTool ExcelReader / Writer活跃 1 万行简单高级特性合并 / 公式受限EasyExcel2024 年起阿里停更任意流式不再有新功能 / bug 修复FastExcel2025 年捐给 Apache、更名 Fesod任意流式已是过渡命名新项目别用Apache Fesod (本文)Apache 孵化中长期保障任意流式仍在 Incubating 阶段2.x API 微调判断很简单新项目→直接 Apache Fesod少一次后续迁移现有 EasyExcel / FastExcel 项目→ 切 Fesod三步走换坐标 改 import 换入口类详见「迁移指南」极简场景几行 Excel → HuTool 一行调用即可别上重武器要做 Excel 转 PDF→ Fesod 内置该能力省得自己拼 itext。基于 Spring Cloud Alibaba Gateway Nacos RocketMQ Vue Element 实现的后台管理系统 用户小程序支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能项目地址https://github.com/YunaiV/yudao-cloud视频教程https://doc.iocoder.cn/video/3 个研发场景什么时候它顶用场景 1百万行报表导出财务、风控、运营部门要导出数十万到百万级订单数据。直接用 POI 一定 OOM——内存里塞百万 row 对象毕竟撑不住。GetMapping(/export/orders) public void exportOrders(HttpServletResponse resp) throws IOException { resp.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); String name URLEncoder.encode(orders, UTF-8); resp.setHeader(Content-disposition, attachment;filename*utf-8 name .xlsx); // 流式写入——分页查 DB 边读边写 try (ExcelWriter writer FesodSheet.write(resp.getOutputStream(), Order.class).build()) { WriteSheet sheet FesodSheet.writerSheet(订单).build(); int page 0, pageSize 5000; while (true) { ListOrder data orderMapper.pageQuery(page, pageSize); if (data.isEmpty()) break; writer.write(data, sheet); } } }收益流式写 分页查 DB每批 5000 条百万行导出内存稳定在 100MB 量级。场景 2用户上传 Excel 批量数据客户给的 Excel 一上传上来就是上万行逐行 INSERT DB 慢、一次性 readAll 又 OOM。Fesod 的事件监听器是为这个场景设计的public class OrderBatchListener extends AnalysisEventListenerOrderRow { privatefinal ListOrderRow buffer new ArrayList(); privatestaticfinalint BATCH_SIZE 500; privatefinal OrderMapper mapper; public OrderBatchListener(OrderMapper mapper) { this.mapper mapper; } Override public void invoke(OrderRow row, AnalysisContext ctx) { buffer.add(row); if (buffer.size() BATCH_SIZE) { mapper.batchInsert(buffer); buffer.clear(); } } Override public void doAfterAllAnalysed(AnalysisContext ctx) { if (!buffer.isEmpty()) mapper.batchInsert(buffer); } }关键设计500 条凑一批 batchInsert——既不让 buffer 撑爆内存又能利用批插提速。场景 3Excel 转 PDF合同 / 工资单工资单、合同模板的常见诉求导出的 Excel 同时给个 PDF 版方便归档 / 打印。FesodSheet.convertToPdf(new File(excelFile.xlsx), new File(pdfFile.pdf), null, null);底层依赖Apache POI itext-pdf——itext 商业用途需注意 AGPL 许可企业项目要么走 itext 商业 license要么换 OpenPDF。接入 3 步依赖 实体类 监听器第 1 步Maven 依赖注意是 Apache 新坐标dependency groupIdorg.apache.fesod/groupId artifactIdfesod-sheet/artifactId version2.0.1-incubating/version /dependency重点groupId是org.apache.fesod——和 EasyExcel 的com.alibaba.excel、FastExcel 的cn.idev.excel都不同。新项目直接用 Apache 坐标少一次后续迁移。第 2 步实体类ExcelProperty注解列名import org.apache.fesod.sheet.annotation.ExcelProperty; Setter Getter ToString public class User { ExcelProperty(编号) private Integer id; ExcelProperty(名字) private String name; ExcelProperty(年龄) private Integer age; }第 3 步事件监听器流式处理是真活public class BaseExcelListenerT extends AnalysisEventListenerT { private final ListT dataList new ArrayList(); Override public void invoke(T t, AnalysisContext ctx) { dataList.add(t); } Override public void doAfterAllAnalysed(AnalysisContext ctx) { log.info(读取完成共 {} 条, dataList.size()); } public ListT getDataList() { return dataList; } }注意监听器决定了内存模型。生产用法应该在invoke里累积 批量落库而不是无脑dataList.add——否则上百万行直接 OOM。核心 API写、读、转 PDF写FesodSheet.write(response.getOutputStream(), User.class) .sheet(模板) .doWrite(buildData());读FesodSheet.read(file.getInputStream(), User.class, listener) .sheet() .doRead();Spring Boot 上传 处理PostMapping(/upload) public ResponseEntityString upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) return ResponseEntity.badRequest().body(请选择文件); try { BaseExcelListenerUser listener new BaseExcelListener(); FesodSheet.read(file.getInputStream(), User.class, listener).sheet().doRead(); log.info(上传 {} 条, listener.getDataList().size()); return ResponseEntity.ok(处理成功); } catch (IOException e) { return ResponseEntity.status(500).body(文件处理失败); } }迁移指南从 EasyExcel / FastExcel 切到 FesodApache Fesod 官方建议分阶段迁移——先换坐标 import再换类名每步都跑测试降低风险。一张表对照三代变化项目EasyExcel阿里FastExcel过渡Apache Fesod最新groupIdcom.alibabacn.idev.excelorg.apache.fesodartifactIdeasyexcelfastexcelfesod-sheet版本3.x停更1.x2.0.1-incubatingimport 包com.alibaba.excel.*cn.idev.excel.*org.apache.fesod.sheet.*入口类EasyExcelFastExcelFesodSheet推荐迁移步骤改 pom换groupId / artifactId / version全局替换 importIDE 一次性cn.idev.excel→org.apache.fesod.sheet或com.alibaba.excel→ 同上替换入口类FastExcel.read/write→FesodSheet.read/write跑回归测试流式写、监听器读、合并单元格、多 sheet 全过一遍。API 完全兼容——上层调用方式ExcelProperty注解、AnalysisEventListener监听器、ExcelWriter写入器一行不动。4 个真实使用边界边界 1仍在 Incubating 阶段API 微调可能最常见2.0.1-incubating是孵化器版本——Apache 孵化项目惯例是 API 还可能有小幅调整。修法① pom 锁死具体版本号② 关注 fesod.apache.org 的 release notes③ 升级前在测试环境跑全套回归。边界 2监听器不要把数据全留在内存常见新人最容易写错的代码// ❌ 上百万行直接 OOM public void invoke(T t, AnalysisContext ctx) { dataList.add(t); }修法累积到 batch 阈值后立刻 flushDB / 队列 / 文件buffer 清空再继续。边界 3Excel 转 PDF 的 itext 许可少见但破坏力大iText 7 是AGPL许可——商用项目不买商业 license不允许闭源。要避坑可以换 OpenPDFLGPL或 Aspose.PDF商业。法务环节别忽略。边界 4和 FastExcel 1.x 二进制不兼容高级场景虽然 API 兼容但FastExcel 1.x 和 Fesod 2.x 在 Maven 依赖树上是两个不同 artifact——同一项目两个都引会出现类冲突。迁移时必须一刀切删掉cn.idev.excel:fastexcel只留org.apache.fesod:fesod-sheet。我的判断EasyExcel → FastExcel → Apache Fesod 的三连跳看着折腾但走到 Apache 这一步意味着这个工具终于有了一个不会再消失的家——基金会保 license、社区保维护、长期 roadmap 由社区共治不再受单家公司 / 单个作者影响。好的开源接班不是另起炉灶是把已有的轮子继续往前转——这次干脆转进了 Apache连维护权都不用再担心。仓库github.com/apache/fesod 官网fesod.apache.org 迁移指南fesod.apache.org/docs/migration/from-fastexcel/欢迎加入我的知识星球全面提升技术能力。 加入方式“长按”或“扫描”下方二维码噢星球的内容包括项目实战、面试招聘、源码解析、学习路线。文章有帮助的话在看转发吧。 谢谢支持哟 (*^__^*