POI 3.16中Cell Iterator异常：目标行/列跳过不稳定问题求助

看来你在POI 3.16处理Excel表格时踩了单元格迭代器的坑，我之前也遇到过类似的问题，大概率是迭代器的默认行为和你的表格结构不匹配导致的，咱们一步步来解决。

首先得明确：POI的cellIterator()默认会跳过物理上不存在的空单元格（也就是那些从未被编辑过的空白列），如果你的表格里Total列之前有空白列、隐藏列或者合并单元格，迭代器就会“跳步”，导致你判断Total列的逻辑混乱，甚至跳过目标行。

正确的处理思路：按列索引遍历，而非依赖Cell Iterator #

与其用迭代器碰运气，不如先定位表头中Total和Forecast列的索引，再按索引遍历数据行，这样逻辑完全可控。

步骤1：定位表头中的关键列索引 #

先遍历表头的所有列（用列索引，而非迭代器），找到Total和Forecast列的位置：

Sheet sheet = workbook.getSheetAt(0);
Row headerRow = sheet.getRow(0); // 假设表头在第一行
int totalColIndex = -1;
int forecastColIndex = -1;

// 遍历表头的每一列（从0到最后一列的索引）
for (int col = 0; col < headerRow.getLastCellNum(); col++) {
    // 把空单元格转为空白单元格，避免空指针
    Cell cell = headerRow.getCell(col, Row.CREATE_NULL_AS_BLANK);
    String cellText = cell.getStringCellValue().trim();
    
    if ("Total".equals(cellText)) {
        totalColIndex = col;
    } else if ("Forecast".equals(cellText)) {
        forecastColIndex = col;
    }
}

// 先校验是否找到必要的列，避免后续逻辑出错
if (totalColIndex == -1 || forecastColIndex == -1) {
    throw new IllegalArgumentException("Excel中未找到Total或Forecast列，请检查表头格式");
}

步骤2：遍历数据行，获取目标值并跳过Total列 #

拿到索引后，遍历数据行时直接按索引取值，完全避开迭代器的坑：

// 从第二行开始遍历数据行（假设第一行是表头）
for (int rowNum = 1; rowNum <= sheet.getLastRowNum(); rowNum++) {
    Row dataRow = sheet.getRow(rowNum);
    if (dataRow == null) {
        continue; // 跳过物理上不存在的空行
    }

    // 获取Forecast列的值，兼容不同单元格类型
    Cell forecastCell = dataRow.getCell(forecastColIndex, Row.CREATE_NULL_AS_BLANK);
    String forecastValue = getCellValueAsString(forecastCell);
    
    // 这里可以处理Forecast值，比如存入集合或打印
    System.out.println("Forecast值：" + forecastValue);

    // 如果需要处理Total列之前的所有列，而不仅仅是Forecast：
    for (int col = 0; col < totalColIndex; col++) {
        Cell cell = dataRow.getCell(col, Row.CREATE_NULL_AS_BLANK);
        String cellValue = getCellValueAsString(cell);
        // 处理每个单元格的值
    }
}

// 辅助方法：将POI单元格转为字符串，兼容不同类型
private String getCellValueAsString(Cell cell) {
    if (cell == null) {
        return "";
    }
    switch (cell.getCellType()) {
        case Cell.CELL_TYPE_STRING:
            return cell.getStringCellValue().trim();
        case Cell.CELL_TYPE_NUMERIC:
            if (DateUtil.isCellDateFormatted(cell)) {
                return cell.getDateCellValue().toString();
            } else {
                // 处理数字，避免科学计数法
                return new DecimalFormat("#.##").format(cell.getNumericCellValue());
            }
        case Cell.CELL_TYPE_BOOLEAN:
            return String.valueOf(cell.getBooleanCellValue());
        default:
            return "";
    }
}

为什么你的Cell Iterator会异常？ #

1. 跳过空单元格：迭代器只会遍历物理上存在的单元格（即曾经编辑过的单元格），如果Total列之前有空白列，迭代器会直接跳过这些列，导致你误以为已经遍历到Total列，但实际列索引不对。
2. 合并单元格/隐藏列：合并单元格只有左上角有物理单元格，其他位置不存在；隐藏列的单元格如果是空的，迭代器也会跳过，这都会打乱你的遍历逻辑。
3. 行的空值处理：如果数据行是物理上不存在的空行（即从未编辑过的行），sheet.getRow(rowNum)会返回null，若直接用迭代器遍历可能跳过，但如果你的逻辑没判断null，就会出现“跳过目标行”的情况。

额外注意事项 #

• POI 3.16的单元格类型常量是Cell.CELL_TYPE_XXX，和新版本的CellType.XXX不兼容，不要混用。
• 用Row.CREATE_NULL_AS_BLANK可以避免空指针，同时统一处理空单元格。
• 如果表格有复杂格式（比如冻结窗格、分组列），记得先确认表头行的索引是否正确。

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