使用Apache POI读取.xlsm文件时行内单元格数量异常问题咨询

这种情况在使用POI读取Excel文件时其实挺常见，不一定是文件格式损坏或数据错误，下面从原因、验证方法和解决思路来拆解：

一、最可能的原因：Excel底层保留了"空单元格元数据" #

Excel界面显示的只是有内容或可见的单元格，但它的底层存储逻辑里，只要某个单元格曾被操作过（比如输入过内容后删除、设置过单元格格式、调整过列宽等），即使现在内容为空，Excel也可能保留这个单元格的记录。而POI的getLastCellNum()方法返回的是该行曾经被使用过的最大列索引+1，所以会读取到这些看似"不存在"的空单元格。

另外一种常见情况是隐藏列：如果该行的某些列被设置为隐藏，Excel界面看不到，但POI会读取到这些列的单元格（不管有没有内容）。

二、如何验证这些情况？ #

• 检查隐藏列：选中该行的所有列（点击行号旁的全选按钮），右键点击列标，选择「取消隐藏」，看看是否会出现之前看不到的列，里面可能就是你说的"不可见数据"。
• 定位空单元格：在Excel中选中该行，按Ctrl+G打开定位窗口，选择「定位条件」->「空值」，如果有大量单元格被选中，说明这些空单元格确实在Excel底层存在。
• 另存为CSV验证：把xlsm文件另存为CSV格式，用记事本或文本编辑器打开CSV，你会看到一行里有很多逗号分隔的空值，后面跟着实际数据——这就是POI读取到的真实结构。
• 排查文件损坏：如果怀疑文件损坏，先尝试用Excel打开原文件，看是否弹出"文件已损坏，尝试修复"的提示；再另存为一个新的xlsm文件，用新文件测试你的读取代码，如果新文件读取正常，说明原文件只是有冗余的元数据，并非损坏。

三、如果不需要这些空单元格，怎么处理？ #

可以在读取时过滤掉空单元格或空白单元格，只处理有实际内容的单元格，修改你的代码如下：

Workbook wb = WorkbookFactory.create(input);
Sheet sheet = wb.getSheetAt(0);
int firstRow = sheet.getFirstRowNum();
int lastRow = sheet.getLastRowNum();

for (int rownum = firstRow; rownum < lastRow; rownum++) {
    Row row = sheet.getRow(rownum);
    if (row == null) continue; // 跳过空行
    short firstCell = row.getFirstCellNum();
    short lastCell = row.getLastCellNum();

    for (int cellnum = firstCell; cellnum < lastCell; cellnum++) {
        Cell cell = row.getCell(cellnum);
        // 判断单元格是否为空或空白内容
        if (cell == null || cell.getCellType() == CellType.BLANK) {
            continue;
        }
        // 根据单元格类型处理值，避免类型转换异常
        String cellValue = "";
        switch (cell.getCellType()) {
            case STRING:
                cellValue = cell.getStringCellValue();
                break;
            case NUMERIC:
                if (DateUtil.isCellDateFormatted(cell)) {
                    cellValue = cell.getDateCellValue().toString();
                } else {
                    cellValue = String.valueOf(cell.getNumericCellValue());
                }
                break;
            case BOOLEAN:
                cellValue = String.valueOf(cell.getBooleanCellValue());
                break;
            default:
                cellValue = "";
        }
        // 后续处理逻辑
        System.out.println("列索引：" + cellnum + "，值：" + cellValue);
    }
}

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