Apache POI解析含CONVERT函数的公式单元格报错，如何获取计算值？

你遇到的问题很典型：Apache POI默认的公式评估器并不支持Excel的CONVERT函数——这个函数属于Excel的Analysis ToolPak（ATP）工具包，但POI的内置ATP实现并没有覆盖所有函数，CONVERT恰好是其中一个未实现的。

下面是具体的解决步骤：

1. 自定义CONVERT函数的实现 #

首先需要自己实现CONVERT函数的转换逻辑，实现POI的Function接口。这里给出一个基础版本（你可以根据业务需求扩展支持更多单位）：

import org.apache.poi.ss.formula.eval.*;
import org.apache.poi.ss.formula.functions.Function;

public class ConvertFunction implements Function {
    @Override
    public ValueEval evaluate(ValueEval[] args, int srcRowIndex, int srcColumnIndex) {
        // CONVERT函数需要3个参数：待转换数值、原单位、目标单位
        if (args.length != 3) {
            return ErrorEval.VALUE_INVALID;
        }

        try {
            // 解析参数值
            double value = NumericValueEval.getDoubleValue(args[0]);
            String fromUnit = TextValueEval.getStringValue(args[1]);
            String toUnit = TextValueEval.getStringValue(args[2]);

            // 执行单位转换
            double result = performUnitConversion(value, fromUnit, toUnit);
            return new NumberEval(result);
        } catch (EvaluationException e) {
            return e.getErrorEval();
        } catch (IllegalArgumentException e) {
            return ErrorEval.VALUE_INVALID;
        }
    }

    private double performUnitConversion(double value, String fromUnit, String toUnit) {
        // 示例：支持米↔英尺、千克↔磅的转换
        if ("m".equalsIgnoreCase(fromUnit) && "ft".equalsIgnoreCase(toUnit)) {
            return value * 3.28084;
        } else if ("ft".equalsIgnoreCase(fromUnit) && "m".equalsIgnoreCase(toUnit)) {
            return value / 3.28084;
        } else if ("kg".equalsIgnoreCase(fromUnit) && "lb".equalsIgnoreCase(toUnit)) {
            return value * 2.20462;
        } else if ("lb".equalsIgnoreCase(fromUnit) && "kg".equalsIgnoreCase(toUnit)) {
            return value / 2.20462;
        }
        // 可继续扩展其他单位对的转换逻辑
        throw new IllegalArgumentException("不支持的单位转换：" + fromUnit + " -> " + toUnit);
    }
}

2. 注册自定义函数到公式评估器 #

接下来把自定义函数注册到POI的公式评估器中，替换掉原来未实现的CONVERT函数：

FileInputStream file = new FileInputStream("files/records/RFQ.xlsx");
XSSFWorkbook workbook = new XSSFWorkbook(file);
Sheet structureBomSheet = workbook.getSheet("Structure BOM");
DataFormatter df = new DataFormatter();

// 创建评估器并注册自定义函数
XSSFFormulaEvaluator objFormulaEvaluator = XSSFFormulaEvaluator.create(workbook, null, null);
objFormulaEvaluator.getWorkbookEvaluator().addFunction("CONVERT", new ConvertFunction());

Row row = structureBomSheet.getRow(2);
Cell cell = row.getCell(3);

// 先评估公式，再获取格式化后的结果
objFormulaEvaluator.evaluate(cell);
String cellValue = df.formatCellValue(cell, objFormulaEvaluator);
logger.info(cellValue);

3. 额外说明 #

• 如果需要支持更多单位，直接在performUnitConversion方法中添加对应逻辑即可，可参考Excel官方的CONVERT函数文档补充单位对。
• 若你的Excel中还用到了其他未实现的ATP函数，也可以用同样的方式自定义实现并注册。
• 注意异常处理，确保参数错误、单位不支持等场景下返回和Excel一致的错误值，保证逻辑兼容性。

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