使用Apache POI添加样式时生成无效Excel XML的问题排查

你遇到的核心问题是：单元格引用了索引为1的样式（s="1"），但生成的styles.xml中cellXfs仅包含1个样式（索引0），导致Excel找不到对应的样式定义，触发修复提示。

这是因为DeferredSXSSFWorkbook的延迟写入机制导致样式没有被正确持久化——它默认仅聚焦于行数据的延迟处理，直接通过DeferredSXSSFWorkbook.createCellStyle创建的样式，没有被正确同步到底层的样式表中，最终不会被写入styles.xml。

直接操作底层的XSSFWorkbook来创建样式和格式，确保样式被正确注册到工作簿的样式集合中，具体修正代码如下：

// 先创建底层XSSF工作簿，所有样式将注册到这里
XSSFWorkbook xssfWorkbook = new XSSFWorkbook();
// 基于XSSF工作簿初始化DeferredSXSSFWorkbook
DeferredSXSSFWorkbook wb = new DeferredSXSSFWorkbook(xssfWorkbook, 100);
DeferredSXSSFSheet sheet1 = wb.createSheet("Sheet1");

// 从底层XSSFWorkbook创建样式
XSSFCellStyle dateStyle = xssfWorkbook.createCellStyle();
XSSFDataFormat dataFormat = xssfWorkbook.createDataFormat();

// 获取日期格式ID："m/d/yy"是Excel内置格式，可直接用内置ID或让POI自动处理
short dateFormatId = xssfWorkbook.getCreationHelper().createDataFormat().getFormat("m/d/yy");
dateStyle.setDataFormat(dateFormatId);

// 构建行和单元格
Row row = sheet1.createRow(0);
Cell cell = row.createCell(0);
cell.setCellStyle(dateStyle);
cell.setCellValue(new Date());

// 写入并关闭资源
try (FileOutputStream fos = new FileOutputStream("output.xlsx")) {
    wb.write(fos);
} finally {
    wb.close();
    xssfWorkbook.close();
}

1. 样式注册到底层XSSFWorkbook：DeferredSXSSFWorkbook是对XSSFWorkbook的包装，所有样式元数据最终存储在底层XSSFWorkbook中，直接操作它创建样式才能保证样式被序列化到styles.xml。
2. 正确处理日期格式ID：
   • 如果使用Excel内置格式（如m/d/yy），可以直接通过getFormat获取内置ID，无需添加自定义格式条目；
   • 如果是自定义日期格式（如yyyy-MM-dd HH:mm:ss），使用dataFormat.getFormat("自定义格式")，POI会自动将格式添加到styles.xml的numFmts节点中。
3. 验证生成的styles.xml：修复后，styles.xml的cellXfs会新增对应样式条目，numFmts也会包含自定义格式（如果使用了非内置格式），单元格的s="1"会对应到有效的样式定义。

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