使用Apache POI读取Excel中SHEET函数时出现错误求助

问题原因 #

报错是因为Apache POI将Excel的SHEET()函数识别为带前缀的_xlfn.SHEET，而POI默认未实现该函数，直接用FunctionEval.registerFunction("SHEET")会失败——因为注册的名称和POI内部识别的不一致。

解决方案 #

临时变通方案：跳过未实现函数的计算 #

如果不需要计算公式结果，只是读取数据或公式文本，可以通过全局设置忽略未实现的函数，避免抛出异常：

// 全局设置：忽略未实现的函数，不会抛出NotImplementedFunctionException
WorkbookEvaluator.setIgnoreMissingFunctions(true);

// 之后正常读取Excel文件
Workbook workbook = WorkbookFactory.create(new File("your-excel-file.xlsx"));

或者直接读取单元格的缓存值（如果Excel已经提前计算过公式结果）：

Sheet sheet = workbook.getSheetAt(0);
for (Row row : sheet) {
    for (Cell cell : row) {
        if (cell.getCellType() == CellType.FORMULA) {
            // 切换为字符串类型读取缓存的计算结果
            cell.setCellType(CellType.STRING);
            String calculatedValue = cell.getStringCellValue();
            // 或者直接获取公式文本
            String formulaText = cell.getCellFormula();
        }
    }
}

永久解决方案：注册自定义_xlfn.SHEET函数 #

通过实现POI的Function接口，注册带前缀的函数名_xlfn.SHEET，模拟Excel的SHEET()函数逻辑：

1. 实现自定义函数类：

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

public class SheetFunction implements Function {
    @Override
    public ValueEval evaluate(ValueEval[] args, int srcRow, int srcCol, EvaluationContext context) {
        try {
            if (args.length == 0) {
                // 无参数时返回当前工作表的索引（Excel中从1开始计数）
                int sheetIndex = context.getWorkbook().getSheetIndex(context.getCurrentSheet()) + 1;
                return new NumberEval(sheetIndex);
            } else {
                // 有参数时，返回参数单元格所在工作表的索引
                ValueEval arg = args[0];
                if (arg instanceof RefEval) {
                    RefEval ref = (RefEval) arg;
                    int sheetIndex = ref.getSheetIndex() + 1;
                    return new NumberEval(sheetIndex);
                }
                return ErrorEval.VALUE_INVALID;
            }
        } catch (Exception e) {
            return ErrorEval.NA;
        }
    }
}

2. 在读取Excel前注册该函数：

// 注册带前缀的函数名，和POI内部识别的名称一致
FunctionEval.registerFunction("_xlfn.SHEET", new SheetFunction());

// 正常读取Excel，此时SHEET()函数会被正确计算
Workbook workbook = WorkbookFactory.create(new File("your-excel-file.xlsx"));

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