POI 3.17版本Formula类型单元格设置小数格式报错求助

这个问题我之前也碰到过，POI从低版本升级到3.17+后，对公式单元格的类型校验变得严格了——在3.7版本里，getStringCellValue()会隐式把公式计算后的数值转成字符串返回，但3.17版本明确要求：如果公式计算结果是数值类型（NUMERIC），你不能直接调用getStringCellValue()，否则就会抛出Cannot get a STRING value from a NUMERIC formula cell这个异常。

核心原因 #

公式单元格（CellType.FORMULA）本身只是存储公式，它的实际值是公式计算后的结果，这个结果有自己的类型（比如NUMERIC、STRING等）。3.7版本的POI会自动帮你做类型转换，而高版本则要求你先明确获取计算结果的类型，再调用对应的值获取方法。

解决方案：用FormulaEvaluator获取计算结果 #

我们需要先通过FormulaEvaluator评估公式，拿到计算后的CellValue，再根据它的类型来处理。修改后的代码如下：

public static void writeDecimal(Cell cell) {
    DecimalFormatSymbols symbols = new DecimalFormatSymbols();
    symbols.setDecimalSeparator('.');
    String pattern = "#0.00";
    DecimalFormat decimalFormat = new DecimalFormat(pattern, symbols);
    decimalFormat.setParseBigDecimal(true);
    
    // 获取公式计算器，用于评估公式的实际计算结果
    FormulaEvaluator evaluator = cell.getSheet().getWorkbook().getCreationHelper().createFormulaEvaluator();
    CellValue cellValue = evaluator.evaluate(cell);
    
    try {
        BigDecimal bigDecimal;
        if (cellValue.getCellType() == CellType.NUMERIC) {
            // 如果计算结果是数值类型，直接转换为BigDecimal
            bigDecimal = BigDecimal.valueOf(cellValue.getNumberValue());
        } else if (cellValue.getCellType() == CellType.STRING) {
            // 如果是字符串类型，沿用原有的解析逻辑
            bigDecimal = (BigDecimal) decimalFormat.parse(cellValue.getStringValue());
        } else {
            // 可根据业务需求补充处理其他类型（如BOOLEAN、ERROR等）
            return;
        }
        
        Double value = bigDecimal.doubleValue();
        cell.setCellType(CellType.NUMERIC);
        cell.setCellValue(value);
    } catch (ParseException e) {
        Logger.getGlobal().log(Level.FINE, e.getMessage(), e);
    }
}

代码说明 #

1. FormulaEvaluator的作用：它会计算公式单元格的实际值，并返回包含值和类型的CellValue对象，让我们能明确知道结果的类型，避免类型不匹配的异常。
2. 分类型处理逻辑：根据计算结果的类型选择对应的取值方式，数值类型直接用getNumberValue()转BigDecimal，字符串类型再用原来的解析逻辑，兼容了两种业务场景。
3. 保留原有业务逻辑：对于字符串类型的公式结果，依然沿用你原来的DecimalFormat解析逻辑，确保业务逻辑的一致性。

这样修改后，无论是数值型还是字符串型的公式计算结果，都能正确处理，不会再抛出类型不匹配的异常了。

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