使用Apache POI计算含PV函数的Excel公式时出现异常求助

问题背景 #

正在实现API数据与Excel数据的自动化对比，以Excel为基准数据源（包含产品负责人提供的公式），要求Excel计算结果与API响应一致。但计算含PV函数的公式时，Apache POI抛出异常。

异常信息 #

Exception in thread "main" java.lang.RuntimeException: Unexpected arg eval type (org.apache.poi.ss.formula.eval.MissingArgEval)
    at org.apache.poi.ss.formula.eval.OperandResolver.coerceValueToDouble(OperandResolver.java:271)
    at org.apache.poi.ss.formula.functions.NumericFunction.singleOperandEvaluate(NumericFunction.java:38)
    at org.apache.poi.ss.formula.functions.FinanceFunction.evaluate(FinanceFunction.java:53)
    at org.apache.poi.ss.formula.functions.FinanceFunction.evaluate(FinanceFunction.java:83)
    at org.apache.poi.ss.formula.OperationEvaluatorFactory.evaluate(OperationEvaluatorFactory.java:153)
    at org.apache.poi.ss.formula.WorkbookEvaluator.evaluateFormula(WorkbookEvaluator.java:541)
    at org.apache.poi.ss.formula.WorkbookEvaluator.evaluateAny(WorkbookEvaluator.java:275)
    at org.apache.poi.ss.formula.WorkbookEvaluator.evaluate(WorkbookEvaluator.java:216)
    at org.apache.poi.xssf.usermodel.BaseXSSFFormulaEvaluator.evaluateFormulaCellValue(BaseXSSFFormulaEvaluator.java:56)
    at org.apache.poi.ss.formula.BaseFormulaEvaluator.evaluateFormulaCell(BaseFormulaEvaluator.java:185)
    at org.apache.poi.ss.formula.BaseFormulaEvaluator.evaluateAllFormulaCells(BaseFormulaEvaluator.java:302)
    at org.apache.poi.xssf.usermodel.XSSFFormulaEvaluator.evaluateAll(XSSFFormulaEvaluator.java:100)
    at com.tekioncloud.common.main.Main.main(Main.java:10)

测试代码 #

public static void main(String arg[]) throws Exception {
        XSSFWorkbook xssfWorkbook = new XSSFWorkbook(new FileInputStream("/Users/aarahman/Documents/ExcelPvCheck.xlsx"));
        xssfWorkbook.getCreationHelper().createFormulaEvaluator().evaluateAll();
    }

环境信息 #

• Java 8
• Apache POI 5.2.3

错误原因 #

根据公式截图内容，Excel中的PV公式存在空参数占位（即公式中出现连续逗号，比如,,）。Excel本身允许省略可选参数并留空占位，但Apache POI的FinanceFunction实现无法处理这种MissingArgEval类型的参数——它会尝试将所有参数强制转换为Double类型，空参数占位会触发类型转换失败，从而抛出异常。

解决方案 #

• 填充可选参数默认值：将Excel中PV公式的空占位参数替换为对应默认值。PV函数语法为PV(rate, nper, pmt, [fv], [type])，省略的[fv]默认是0，[type]默认是0，可把公式中的,,改为,0,0。
• 自定义函数处理逻辑：若无法修改Excel公式，可自定义PV函数的Evaluator，处理MissingArgEval类型参数，将其转换为对应默认值后再计算。
• 升级POI版本：检查后续Apache POI版本是否修复了该兼容问题，部分新版本对缺失参数的处理更贴合Excel原生行为。

内容的提问来源于stack exchange，提问作者Ahamed Abdul Rahman