使用Apache POI生成Excel触发单元格样式上限告警的影响是什么

报错说明 #

你收到的报错完整信息为：

java.lang.IllegalStateException: The maximum number of Cell Styles was exceeded. You can define up to 64000 style in a .xlsx Workbook

该报错出现警告级别提示但Excel文件仍可正常生成，是Apache POI版本迭代调整处理逻辑导致的，具体影响如下：

具体影响 #

• 版本差异导致的表现不同：POI 4.x早期版本对样式超量的处理逻辑是直接抛出异常、中断文件生成，这是旧参考内容中提到无法生成表格的原因；4.1.2之后的版本以及5.x全系列调整为警告提示+自动复用已有样式的逻辑，不会中断生成流程，只要超量的样式大多是重复定义的相同格式，自动复用后最终文件显示效果就会符合预期。
• 生成性能损耗：超量后POI需要遍历全量已有样式表做匹配复用，会额外消耗CPU和内存资源，当处理数据量较大时，生成耗时会明显上升，严重时可能触发OOM异常。
• 样式丢失风险：如果业务场景确实存在超过64000种完全不重复的自定义样式需求，超出部分的样式不会被创建，对应单元格会 fallback 到默认格式，出现样式不符合预期的问题。
• 下游兼容性问题：部分版本的微软Office、WPS打开超过样式阈值的Excel文件时，会弹出文件损坏提示，或自动清除超出的样式，导致文件打开后显示异常。

解决方案 #

核心是避免在单元格遍历逻辑中重复创建CellStyle实例，将相同格式的样式提前定义为全局变量，所有同格式单元格共用同一个样式实例即可彻底解决样式超量问题。

内容的提问来源于stack exchange，提问作者blue-sky