Apache POI验证AGGREGATE函数公式失败的解决方法

通过Java程序使用Apache POI（XSSF）向Excel写入数据后，校验预置公式时遇到AGGREGATE函数处理失败，报错信息如下：

计算单元格 'MS Roadmap'!WC1 时出错
触发原因：org.apache.poi.ss.formula.eval.NotImplementedFunctionException: _xlfn.AGGREGATE

报错单元格为法语环境，公式内容为：

=AGREGAT(9;2;WD1:WG1)

跳过POI侧公式校验生成的文件，打开后按F9也无法强制更新公式计算结果。

• Apache POI 未内置实现 AGGREGATE（法语环境下本地化函数名为AGREGAT）的公式求值逻辑，这类POI暂不支持的较新Excel函数会被自动添加_xlfn.前缀标记，调用POI自带公式求值器时会直接抛出NotImplementedFunctionException。
• 跳过POI侧公式计算后，打开文件按F9无法触发重算，是因为POI生成文件时默认未设置「打开时强制全量重算」标记，Excel会直接读取单元格缓存的空值/旧值，不会主动触发公式计算。

根据业务场景二选一即可：

方案1：无需Java侧获取计算结果，强制Excel端自动重算 #

该方案改动最小，适合只需要最终用户打开Excel时公式正常生效、不需要在程序内校验公式计算结果的场景：

• 完成所有单元格数据写入后，不要调用POI的FormulaEvaluator执行公式计算，直接给工作簿设置强制重算标记，代码示例：

// 假设你操作的是已创建的XSSFWorkbook实例
XSSFWorkbook workbook = [你的工作簿实例];
// 写入业务数据、预置公式的逻辑省略
// 核心配置：打开文件时强制Excel重算全量公式
workbook.setForceFormulaRecalculation(true);
// 后续执行文件输出流写入逻辑即可

• 配置生效后，用户打开生成的Excel文件时会自动触发全表公式重算，不需要手动按F9，AGREGAT/AGGREGATE函数由Excel原生计算引擎执行，不存在兼容性问题。

方案2：需要在Java侧完成公式校验/求值 #

如果业务要求必须在程序内完成公式验证、拿到公式计算结果，需要给POI自定义注册AGGREGATE函数的实现：

• 实现org.apache.poi.ss.formula.functions.Function接口，按照AGGREGATE的函数规则编写计算逻辑：第一个参数为计算功能号（当前场景用的9对应SUM求和），第二个参数为忽略规则（当前场景用的2对应忽略隐藏行、错误值），无需实现全量19种功能规则，仅覆盖业务实际用到的功能号即可。
• 将自定义实现注册到POI的函数表，注意同时注册通用函数名和法语本地化函数名，避免多语言环境识别失败：

// 自定义AGGREGATE函数实现实例
Function customAggregate = new CustomAggregateFunction();
// 注册通用函数名
FunctionEval.registerFunction("AGGREGATE", customAggregate);
// 注册法语环境函数名
FunctionEval.registerFunction("AGREGAT", customAggregate);

• 注册完成后再调用FormulaEvaluator执行逐单元格/全表公式验证，就不会抛出未实现函数的异常。

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