Apache Poi执行含特殊字符的Excel公式失败问题求助

架构老林

2026-7-26

解决Apache POI解析含日文特殊字符工作表名公式的问题

问题根源

Excel允许工作表名包含「【」这类特殊字符，但Apache POI的公式解析器严格遵循语法规则：当工作表名包含特殊字符时，必须用单引号将表名括起来，否则会抛出FormulaParseException。原公式SUM(E4,【一日】!B2)不符合该规则，导致解析失败。

解决方案（无需修改原Excel工作表名）

通过预处理公式，自动给包含特殊字符的工作表名添加单引号，再交由POI解析计算。

步骤1：实现公式预处理方法

编写工具方法，匹配公式中类似【xxx】!的工作表引用模式，将其替换为'【xxx】'!：

private static String processSpecialSheetNameFormula(String originalFormula) {
    // 匹配【xxx】!格式的工作表引用，给表名加单引号
    return originalFormula.replaceAll("(【[^】]+】)!", "'$1'!");
}

步骤2：修改原有代码，添加预处理逻辑

在调用evaluateInCell前，先预处理公式并重新设置到单元格：

case FORMULA: {
    String originalFormula = cell.getCellFormula();
    String processedFormula = processSpecialSheetNameFormula(originalFormula);
    
    try {
        System.out.println(processedFormula + " execute...");
        // 重新设置处理后的公式到单元格
        cell.setCellFormula(processedFormula);
        evaluator.evaluateInCell(cell);
        System.out.println(processedFormula + " execute success...");
    } catch (Exception e) {
        System.out.println(String.format("Paste the value error in the Cell: %s", cell.getAddress()) + "   :");
        System.out.println(originalFormula + " failed");
        e.printStackTrace(); // 可选：打印详细异常信息排查
    }
    break;
}