Java Apache POI读取Excel报错：无法从数值单元格获取字符串值

报错核心原因 #

Apache POI读取Excel时，会严格依据单元格的实际存储类型而非显示格式来处理。即便Excel中单元格显示为文本，若实际存储为数值（比如未设置文本格式的数字、公式生成的文本型显示内容），直接调用getStringCellValue()就会抛出IllegalStateException: Cannot get a STRING value from a NUMERIC cell。

具体解决方法 #

1. 先判断单元格类型，再针对性读取

这是最稳妥的方案，避免强制类型转换带来的问题：

Cell cell = row.getCell(cellIndex);
String cellValue = "";
if (cell != null) {
    switch (cell.getCellType()) {
        case STRING:
            cellValue = cell.getStringCellValue();
            break;
        case NUMERIC:
            // 根据列索引区分处理：A、B列转字符串，C列保留数值逻辑
            if (cellIndex == 2) { // C列（价格列）
                // 用BigDecimal避免浮点精度丢失
                BigDecimal price = new BigDecimal(cell.getNumericCellValue());
                cellValue = price.toPlainString();
            } else { // A、B列（文本列）
                // 按整数格式转字符串，避免科学计数法
                cellValue = new DecimalFormat("0").format(cell.getNumericCellValue());
            }
            break;
        case BLANK:
            cellValue = "";
            break;
        default:
            cellValue = cell.toString();
    }
}
// 后续处理cellValue

2. 特定列强制转为文本读取（仅适合文本列）

如果确定A、B列应该是文本，可先将单元格类型转为STRING再读取，但注意数值型转文本可能出现科学计数法问题，不建议用于价格列：

Cell cell = row.getCell(cellIndex);
if (cell != null && cellIndex != 2) { // 仅处理A、B列
    cell.setCellType(CellType.STRING);
    String cellValue = cell.getStringCellValue();
}

3. 检查Excel文件的实际单元格属性

• 右键单元格→「设置单元格格式」，确认A、B列是否真的设置为「文本」类型；
• 若单元格是公式生成的文本显示（比如=TEXT(A1,"0000")），其实际存储类型仍为数值，需按数值类型处理后再转字符串。

关键提示 #

你替换代码为打印语句仍报错，说明问题出在读取单元格的操作本身，必须先完成单元格类型判断或转换，再执行任何打印、赋值操作。

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