Java生成Excel文件无法上传，经Excel保存后恢复正常的问题排查

• 依赖第三方网站工具上传并处理Excel文件，文件需包含指定列，上传完成后才会校验列与数据
• 人工用Excel创建的文件可正常上传，但Java代码生成的文件上传失败
• 将Java生成的文件用Excel打开，不做任何修改仅按Ctrl+S保存后，即可正常上传
• 怀疑Java代码缺失Excel保存时自动添加的某些步骤，且无法查看第三方工具日志排查问题

生成文件的Java代码 #

// 外层列表对应行，内层列表对应单元格值
List<List<String>> rowsList = new ArrayList<>();
// 省略rowsList的填充逻辑

XSSFWorkbook workbook = new XSSFWorkbook();
XSSFSheet sheet = workbook.createSheet(sheetName);

for (int rn = 0; rn < rowsList.size(); rn++) {
    List<String> rowData = rowsList.get(rn);
    if (rowData.size() > 0) {
        XSSFRow row = sheet.createRow((short) rn);
        for (int cn = 0; cn < rowData.size(); cn++) {
            String val = rowData.get(cn);
            XSSFCell theCell = row.createCell(cn);
            theCell.setCellValue(val);
        }
    }
}

try (FileOutputStream fileOut = new FileOutputStream(fileName);) {
    workbook.write(fileOut);
    workbook.close();
} catch (IOException e) {
    throw new Exception(e.getMessage(), e);
}

Java POI库生成的XLSX文件，与Excel原生保存的文件存在细微结构差异：

• 缺少Excel自动添加的默认样式、格式元数据
• 单元格类型未显式指定，POI的自动推断可能与Excel保存后的类型不一致
• 工作表的视图、打印等属性未设置，不符合第三方工具的隐性校验规则

1. 显式指定单元格类型为字符串 #

避免POI自动推断单元格类型带来的差异，强制设置为字符串类型：

// 创建单元格时指定类型为STRING
XSSFCell theCell = row.createCell(cn, CellType.STRING);
theCell.setCellValue(val);

2. 添加Excel默认样式 #

模拟Excel原生的默认单元格样式（字体、字号等）：

// 创建默认样式
XSSFCellStyle defaultCellStyle = workbook.createCellStyle();
XSSFFont defaultFont = workbook.createFont();
defaultFont.setFontName("Calibri");
defaultFont.setFontHeightInPoints((short)11);
defaultCellStyle.setFont(defaultFont);

// 给每个单元格应用默认样式
theCell.setCellStyle(defaultCellStyle);

3. 补全工作表属性 #

添加Excel默认的视图、打印相关属性：

// 设置默认缩放比例
sheet.setZoom(100);
// 设置打印区域（适配数据范围）
sheet.setPrintArea(0, 0, rowData.size() - 1, 0, rowsList.size() - 1);
// 添加默认页眉页脚
XSSFHeaderFooter headerFooter = sheet.getHeaderFooter();
headerFooter.setOddHeader("&C&12" + sheetName);
headerFooter.setOddFooter("&C&P/&N");

4. 切换为SXSSF生成文件（大数据量场景） #

如果文件数据量较大，使用SXSSF（流式API）生成的文件更接近Excel原生结构：

// 替换XSSFWorkbook为SXSSFWorkbook
SXSSFWorkbook workbook = new SXSSFWorkbook();
// 后续代码逻辑与原代码一致
// 最后需清理临时文件
workbook.dispose();

5. 模拟人工保存操作（兜底方案） #

若上述方案无效，可在代码中重新打开生成的文件并保存，模拟Ctrl+S的效果：

// 重新打开并保存文件
try (XSSFWorkbook reSavedWorkbook = new XSSFWorkbook(new FileInputStream(fileName));
     FileOutputStream outputStream = new FileOutputStream(fileName)) {
    reSavedWorkbook.write(outputStream);
} catch (IOException e) {
    throw new RuntimeException(e);
}

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