使用Apache POI基于Excel模板生成文件后大小异常需手动保存的问题

问题原因 #

使用POI读取Excel模板并写入数据后，POI会自动清理文件中的冗余元数据（比如未使用的样式、格式缓存、空单元格的格式信息、公式计算缓存等），这些内容是原模板16KB大小的组成部分，但POI判定它们为非必要内容，因此生成的文件仅13KB。手动用Excel打开保存时，Excel会重新生成这些元数据，文件大小便恢复为原模板的尺寸。

解决方案 #

1. 用OPCPackage加载模板（推荐） #

对于.xlsx格式模板，避免直接用FileInputStream加载，改用OPCPackage打开，能完整保留模板的结构和元数据：

// 打开模板包
OPCPackage pkg = OPCPackage.open(new File("你的模板路径.xlsx"));
// 初始化XSSFWorkbook
XSSFWorkbook workbook = new XSSFWorkbook(pkg);
// 如果用SXSSFWorkbook，基于XSSFWorkbook初始化
SXSSFWorkbook sxssfWorkbook = new SXSSFWorkbook(workbook, 100);

// 写入数据逻辑...

// 输出文件并关闭资源
try (FileOutputStream out = new FileOutputStream("生成的文件路径.xlsx")) {
    sxssfWorkbook.write(out);
} finally {
    sxssfWorkbook.dispose();
    pkg.close();
}

2. 禁用POI的未使用样式清理 #

如果必须用FileInputStream，可以关闭POI自动清理未使用样式的功能，保留模板中的所有样式信息：

XSSFWorkbook workbook = new XSSFWorkbook(new FileInputStream("模板路径.xlsx"));
// 获取样式源并禁用清理
XSSFStyleSource styleSource = workbook.getStylesSource();
styleSource.setCleanupUnusedStyles(false);

// 写入数据...

3. 保留公式计算缓存 #

若模板包含公式，POI默认不会保留计算缓存，手动保存时Excel会重新计算生成缓存导致文件变大。如果需要提前生成缓存，可强制计算公式：

FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
for (Sheet sheet : workbook) {
    for (Row row : sheet) {
        for (Cell cell : row) {
            if (cell.getCellType() == CellType.FORMULA) {
                evaluator.evaluate(cell);
            }
        }
    }
}

补充说明 #

• SXSSFWorkbook是内存优化工具，本身不会导致文件大小问题，核心还是模板读取时的元数据保留设置。
• 如果文件大小差异不影响功能，其实无需特意处理，手动保存只是Excel重新整理了文件结构，数据本身是完整的。

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