本文介绍java/kotlin中使用apache poi读取复制后未经手动打开/保存的excel文件时数据不可见的问题成因与解决方案，重点通过强制重计算公式并刷新文件内容，使程序能直接读取原始值。
本文介绍java/kotlin中使用apache poi读取复制后未经手动打开/保存的excel文件时数据不可见的问题成因与解决方案，重点通过强制重计算公式并刷新文件内容，使程序能直接读取原始值。
该问题的根本原因在于：当 Excel 文件被复制（尤其是从模板或自动化生成场景中复制）而未被 Excel 应用程序打开过时，其内部缓存的公式计算结果（cached formula results）可能为空或无效。Apache POI 的 XSSFFormulaEvaluator 在调用 evaluate() 时，若单元格未预存计算结果（即 cell.getCachedFormulaResultType() 为 CELL_TYPE_BLANK 或异常），将无法返回有效字符串——即使公式本身语法正确、逻辑完备。
你原代码中的关键缺陷有三处：
-
重复创建 Workbook 实例：每次调用
excelReader()都新建FileInputStream和XSSFWorkbook，导致资源泄漏且无法共享公式计算上下文； -
evaluateAll()调用无效：wb.getCreationHelper().createFormulaEvaluator().evaluateAll()创建的是一个临时、未绑定到当前 Workbook 的 evaluator，对实际单元格无影响； - 未处理公式单元格的原始值回写：POI 读取公式单元格时默认依赖缓存值，而复制文件往往缺失该缓存。
✅ 正确解法是：在读取前，先以写模式加载文件 → 强制全量公式重计算 → 将更新后的缓存结果持久化回磁盘 → 再重新加载用于读取。
以下是推荐的修复流程（Kotlin 示例）：
fun ensureExcelFormulasEvaluated(filePath: String) {
FileInputStream(filePath).use { fis ->
val wb = XSSFWorkbook(fis)
// 关键：使用与Workbook绑定的evaluator执行全量重计算
val evaluator = wb.creationHelper.createFormulaEvaluator()
evaluator.evaluateAll()
// 将计算结果写回原文件（覆盖）
FileOutputStream(filePath).use { fos ->
wb.write(fos)
}
}
}
然后在你的主逻辑前调用它：
// ✅ 调用预处理（仅需一次）
ensureExcelFormulasEvaluated(filePath)
// ✅ 此时再安全读取（建议复用Workbook实例，避免重复IO）
val fis = FileInputStream(filePath)
val wb = XSSFWorkbook(fis)
val sheet = wb.getSheetAt(4) // 注意：sheet索引从0开始，原代码中传入4对应第5个sheet
val evaluator = wb.creationHelper.createFormulaEvaluator()
var rowExcel = 1
while (true) {
val cellRef = CellReference("A$rowExcel")
val row = sheet.getRow(cellRef.row)
val cell = row?.getCell(cellRef.col) ?: break
// 安全获取字符串值：优先取缓存结果，失败则尝试计算
val value = when (cell.cellType) {
CellType.FORMULA -> {
val evalResult = evaluator.evaluate(cell)
evalResult.stringValue.ifEmpty { cell.stringCellValue }
}
else -> cell.stringCellValue
}
if (value.isBlank()) break
data.appendText("$value\r\n")
rowExcel++
}
wb.close()
fis.close()
⚠️ 注意事项：
-
XSSFFormulaEvaluator.evaluateAllFormulaCells(wb)是静态方法，但仅适用于.xlsx（XSSF）；若处理.xls（HSSF），请改用HSSFFormulaEvaluator.evaluateAll()； - 预处理步骤会修改原始文件，如需保持源文件只读，请先复制一份临时文件再处理；
- 对于含大量公式的大型文件，
evaluateAll()可能带来轻微性能开销，但远低于人工干预成本； - 始终使用
try-with-resources（Kotlin 中use{}）确保流及时关闭，防止文件句柄泄露。
总结：Excel 复制文件的“未激活”状态本质是缓存缺失问题。通过 evaluateAll() + write() 组合实现缓存预热，即可让 Apache POI 无需人工介入即可稳定读取所有可见数据——这是生产环境中自动化 Excel 处理的必备健壮性实践。
