使用Apache POI读取Excel时遭遇NullPointerException问题求助

嘿，我完全懂你现在的困扰——处理Excel里的空单元格时踩NullPointerException的坑真的很头疼，尤其是Apache POI在处理空白行/未初始化单元格时的逻辑很容易让人踩雷。我来给你梳理下问题根源和具体的解决办法：

问题根源 #

你遇到的NPE，大概率不是因为单元格本身是null这么简单，而是两种情况：

1. 某行完全空白，POI的Sheet对象根本不会创建这行的Row实例，直接调用getRow(rowNum)会返回null，这时再去拿第0列单元格就会触发NPE；
2. 行存在，但第0列的单元格从未被初始化过（比如只是空白，没有输入过任何内容），直接getCell(0)会返回null，调用单元格方法就炸了。

具体解决步骤 #

1. 先检查行是否存在

循环遍历行的时候，先判断当前行是否为null，避免后续操作空指针：

Row currentRow = sheet.getRow(rowNum);
if (currentRow == null) {
    // 该行完全空白，直接跳过
    continue;
}

2. 安全获取单元格，避免null

POI提供了MissingCellPolicy参数，让我们可以把不存在的单元格转为空白单元格，而不是返回null。推荐用CREATE_NULL_AS_BLANK策略：

// 获取第0列单元格，不存在则自动创建空白单元格
Cell targetCell = currentRow.getCell(0, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);

3. 准确判断单元格是否有有效文本

现在单元格不会是null了，接下来要判断它是否真的有内容。这里要注意两种情况：单元格是空白类型，或者文本内容为空/全是空格。

如果你用的是POI 4.x及以上版本（推荐）：

if (targetCell.getCellType() == CellType.BLANK || targetCell.getStringCellValue().trim().isEmpty()) {
    // 无有效文本，跳过该行
    continue;
}

如果是POI 3.x旧版本，要用getCellTypeEnum()：

if (targetCell.getCellTypeEnum() == CellType.BLANK || targetCell.getStringCellValue().trim().isEmpty()) {
    continue;
}

4. 进阶：用DataFormatter统一处理所有单元格类型

如果你的第0列可能包含数字、日期等非文本类型，直接用getStringCellValue()会报错。这时候可以用DataFormatter把任何类型的单元格值转为字符串，再判断是否为空：

DataFormatter formatter = new DataFormatter();
String cellContent = formatter.formatCellValue(targetCell);
if (cellContent.trim().isEmpty()) {
    continue;
}

完整示例代码 #

把这些逻辑整合起来，你的代码大概会是这样：

DataFormatter formatter = new DataFormatter();
Sheet sheet = workbook.getSheetAt(0);

for (int rowNum = 0; rowNum <= sheet.getLastRowNum(); rowNum++) {
    Row currentRow = sheet.getRow(rowNum);
    if (currentRow == null) {
        continue;
    }

    // 安全获取第0列单元格
    Cell column0Cell = currentRow.getCell(0, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
    String cellText = formatter.formatCellValue(column0Cell);

    // 检查是否有有效文本
    if (cellText.trim().isEmpty()) {
        continue;
    }

    // 执行你的复制逻辑：处理当前行+1到+3行，列2-4的内容
    for (int offset = 1; offset <= 3; offset++) {
        Row targetRow = sheet.getRow(rowNum + offset);
        if (targetRow == null) {
            continue;
        }
        for (int col = 2; col <= 4; col++) {
            Cell sourceCell = targetRow.getCell(col, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
            String cellValue = formatter.formatCellValue(sourceCell);
            // 这里写你的复制/转换逻辑，比如把值存到新的Excel或者集合里
            System.out.println("复制内容：" + cellValue);
        }
    }
}

额外注意点 #

• 遍历行的时候，要用sheet.getLastRowNum()来获取最后一行的索引，确保不会漏掉任何行；
• 处理目标行（rowNum+1到+3）时，也要检查行是否存在，避免因为超出表格范围导致NPE；
• 如果你的Excel是.xls格式（HSSF），逻辑和.xlsx（XSSF）是一致的，上面的代码两种格式都适用。

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