使用Apache POI XSSF不新建行覆写现有Excel指定单元格时空指针异常咨询

问题根因 #

• sheet.getRow(rowIndex) 方法仅返回Excel文件中物理存在、已初始化实体的行对象：如果对应行号从未写入过任何单元格值、格式、批注等内容，哪怕Excel界面里能看到网格线，POI层面也不会为这个空行创建对应实体，调用方法就会返回null，这是POI的底层存储设计，不是代码逻辑错误。
• 原代码存在固定对象复用的逻辑漏洞：最外层仅取了一次第18行第0列的cell对象，后续循环全程复用这同一个cell赋值，哪怕行、单元格实体都存在，也只会不停覆盖同一个固定单元格的值，完全无法按二维数组的维度写入x行y列的范围。

不新建实体的覆写实现要求 #

要严格满足“不新建行/单元格，仅覆写已有实体值”的要求，代码逻辑必须符合以下规则：

• 全程不调用sheet.createRow()、row.createCell()这类会创建新实体的API，完全依赖POI对已有文件的实体识别
• 每次获取目标行、目标单元格时必须做空校验：如果返回值为null，说明该位置根本不是物理存在的实体，直接抛出业务提示即可，绝对不能走新建分支兜底
• 每个循环节点都要重新按目标行号、列号获取对应的实体对象，不能跨循环复用行、cell的引用

修正后的参考实现代码 #

Integer columns = DataImport.columns_in_sheet[0];
Integer rowNum = learnerRow + 2;

try (FileInputStream inp = new FileInputStream("D:/location/update.xlsx")) {
    XSSFWorkbook wb = (XSSFWorkbook) WorkbookFactory.create(inp);
    XSSFSheet sheet = wb.getSheetAt(0);

    for (int j = 0; j < exportData.length; j++) {
        // 仅获取已存在的行实体，不触发新建
        XSSFRow currentRow = sheet.getRow(rowNum + j);
        if (currentRow == null) {
            throw new RuntimeException("第" + (rowNum + j) + "行无实际存在的单元格实体，无法执行覆写");
        }

        for (int i = 0; i < columns; i++) {
            // 仅获取已存在的单元格实体，不触发新建
            XSSFCell currentCell = currentRow.getCell(i);
            if (currentCell == null) {
                throw new RuntimeException("第" + (rowNum + j) + "行第" + i + "列无实际存在的单元格实体，无法执行覆写");
            }
            currentCell.setCellType(CellType.STRING);
            currentCell.setCellValue(exportData[j][i]);
        }
    }

    // 独立管理写流，避免和读流产生文件锁冲突
    try (FileOutputStream fileOut = new FileOutputStream("D:/location/update.xlsx")) {
        wb.write(fileOut);
    }
    wb.close();
} catch (FileNotFoundException e) {
    e.printStackTrace();
} catch (IOException e) {
    e.printStackTrace();
}

常见认知误区 #

• Excel界面看到的网格线不等于物理存在的行/单元格：只有单元格附带了任意实体内容（值、格式、批注、条件格式等），POI才会将其识别为可操作的行/单元格。如果目标写入区域是完全空白的网格，本质上不存在可覆写的实体，是不可能实现“不新建就赋值”的效果的。
• 不要用创建行/单元格的逻辑做“空值兜底”：一旦调用create相关方法，就算作新建实体，就不符合初始需求的约束。

内容的提问来源于stack exchange，提问作者Timmus-1