使用Apache POI更新Excel单元格时触发NullPointerException问题排查

我来帮你拆解这个NPE问题，看你的代码里有几个关键的错误点，这也是Apache POI操作Excel时的常见坑：

核心问题分析 #

1. 工作簿初始化错误
   你用new XSSFWorkbook()创建了一个全新的空工作簿，但你实际要更新的是已存在的D:\\TempLocation\\Marks.xlsx文件——根本没加载这个目标文件！这就导致wb.getSheet(sheetName)返回null，后续调用sheet.getRow(0)自然抛出NullPointerException。

2. 行/单元格的非空判断缺失
   就算加载了正确的工作簿，getRow(int)和getCell(int)都可能返回null（比如指定行从未被创建过，或者单元格从未被编辑过），直接链式调用sheet.getRow(0).getCell(0)必然会触发NPE。

修正后的完整代码 #

import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFCell;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelMarkUpdater {
    public static void main(String[] args) throws IOException {
        String excelFileName = "D:\\TempLocation\\Marks.xlsx";
        String sheetName = "Sheet1";
        int mark = 90; // 替换为你要设置的实际分数

        // 使用try-with-resources自动关闭流，避免资源泄漏
        try (FileInputStream fis = new FileInputStream(excelFileName);
             XSSFWorkbook wb = new XSSFWorkbook(fis);
             FileOutputStream fos = new FileOutputStream(excelFileName)) {

            // 获取工作表，不存在则创建（根据业务需求选择是否创建）
            XSSFSheet sheet = wb.getSheet(sheetName);
            if (sheet == null) {
                sheet = wb.createSheet(sheetName);
                System.out.println("工作表不存在，已创建新工作表：" + sheetName);
            }

            // 获取行，不存在则创建
            XSSFRow row = sheet.getRow(0);
            if (row == null) {
                row = sheet.createRow(0);
            }

            // 获取单元格，不存在则创建
            XSSFCell cellToUpdate = row.getCell(0);
            if (cellToUpdate == null) {
                cellToUpdate = row.createCell(0);
            }

            // 更新单元格值
            cellToUpdate.setCellValue(mark);
            System.out.println("已成功更新单元格值为：" + mark);

            // 将修改后的工作簿写回文件
            wb.write(fos);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

关键注意事项 #

• 必须通过FileInputStream加载现有Excel文件，而不是直接新建空工作簿。
• 对sheet、row、cell都要做非空校验，不存在则按需创建，彻底避免NPE。
• 如果你的文件是.xls格式（旧版Excel），需要替换为HSSFWorkbook，而不是XSSFWorkbook。
• 记得用FileOutputStream将修改后的工作簿写回原文件，否则所有修改都只在内存中，不会保存到磁盘。

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