Apache POI公式解析异常：如何不修改单元格名评估含3字母单元格？

问题背景 #

使用XSSF读取Excel文件，执行以下代码评估公式时：

FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
evaluator.evaluateAll();

抛出FormulaParseException，错误提示：

Dotted range (full row or column) expression 'C.aRG' must have exactly 2 dots.

该问题源于Apache POI的公式解析逻辑缺陷：将含三个字母的单元格名称（如示例中的aRG）误识别为列名，触发了点语法的错误解析规则。此问题属于POI已知未修复Bug（Bug编号65963）。

无需修改单元格名称的解决方法 #

1. 内存中临时修改公式字符串 #

在读取单元格公式后，对其中的三字母标识符添加单引号包裹，强制POI将其识别为单元格名称而非列名，再执行公式评估：

// 获取目标单元格
Cell cell = sheet.getRow(rowIndex).getCell(cellIndex);
String originalFormula = cell.getCellFormula();

// 对公式中的三字母标识符添加单引号（正则匹配需根据实际场景调整）
String fixedFormula = originalFormula.replaceAll("\\b([a-zA-Z]{3})\\b", "'$1'");

// 临时设置修改后的公式并评估
cell.setCellFormula(fixedFormula);
evaluator.evaluate(cell);

// 可选：评估完成后恢复原公式
cell.setCellFormula(originalFormula);

2. 自定义公式解析器 #

通过扩展POI的FormulaParser类，重写标识符解析逻辑，针对三字母单元格名称做特殊处理：

public class CustomFormulaParser extends FormulaParser {
    public CustomFormulaParser(FormulaParsingWorkbook workbook, String formula, ParseNode rootNode, int formulaType) {
        super(workbook, formula, rootNode, formulaType);
    }

    @Override
    protected ParseNode parseIdentifier() throws FormulaParseException {
        String token = getToken();
        // 判断是否为纯三字母的单元格名称
        if (token != null && token.matches("^[a-zA-Z]{3}$")) {
            // 强制将其解析为单元格名称节点
            return new NamePtg(token).createParseNode(this);
        }
        return super.parseIdentifier();
    }
}

之后需要自定义FormulaEvaluator的创建逻辑，替换默认的解析器实现，确保使用自定义解析器处理公式。

3. 跟进POI版本更新 #

该问题已在Apache Bugzilla上记录（编号65963），可尝试升级至POI最新稳定版本，查看是否有临时修复或正式补丁。若后续版本修复了此解析缺陷，直接升级即可解决问题。

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