使用Apache POI读取Excel人工输入数值的问题求助

问题概述 #

• 需要读取Excel（xlsx/xls格式）中人工输入的数值
• DataFormatter.formatCellValue()无法满足需求：若单元格设置了两位小数格式，返回的是带两位小数的格式化结果，而非实际输入的原始数值
• getNumericCellValue()存在精度异常：常规格式单元格显示为“1”，但读取返回0.999999999998，另存为CSV用记事本查看显示正常，无法定位误差来源
• SetCellType(STRING)已被废弃
• 涉及的数值不一定是整数，直接对double取整或依赖浮点数处理会引入精度问题（使用POI版本为5.4.0）

可行解决思路 #

1. 基于显示文本转换为高精度数值 #

Excel显示的数值是经过舍入的，和用户输入的感知一致，可通过DataFormatter获取显示文本，再转为BigDecimal避免浮点数误差：

DataFormatter formatter = new DataFormatter();
String displayedText = formatter.formatCellValue(cell);
BigDecimal actualValue = new BigDecimal(displayedText);

这种方式直接匹配用户看到的数值，不受单元格格式限制，同时保证精度。

2. 结合单元格格式规则解析数值 #

读取单元格的格式规则，自定义DecimalFormat来解析，兼顾原始数值和格式适配：

CellStyle cellStyle = cell.getCellStyle();
DataFormat dataFormat = cell.getSheet().getWorkbook().createDataFormat();
String formatPattern = dataFormat.getFormatString(cellStyle.getDataFormat());
// 清理格式字符串中的非数值格式符（如货币符号、千分位符）
formatPattern = formatPattern.replaceAll("[^0-9.#E-]", "");
DecimalFormat decimalFormat = new DecimalFormat(formatPattern);
decimalFormat.setParseBigDecimal(true);
BigDecimal parsedValue = (BigDecimal) decimalFormat.parse(formatter.formatCellValue(cell));

此方法更灵活，能适配不同格式的数值解析场景。

3. 直接读取Excel底层存储的原始数值（XLSX专属） #

XLSX基于OOXML格式，可直接解析底层XML获取单元格的原始数值字符串，绕过POI的浮点数转换：

if (cell instanceof XSSFCell) {
    XSSFCell xssfCell = (XSSFCell) cell;
    CTCell ctCell = xssfCell.getCTCell();
    if (ctCell.isSetV()) {
        String rawStoredValue = ctCell.getV();
        BigDecimal actualValue = new BigDecimal(rawStoredValue);
    }
}

该方法能拿到Excel实际存储的原始数值，但仅适用于XLSX格式，XLS需单独处理HSSF的底层结构。

4. 修正浮点数精度误差的通用方法 #

如果必须使用getNumericCellValue()，可通过BigDecimal的舍入规则修正误差：

double rawDoubleValue = cell.getNumericCellValue();
// 根据显示文本判断小数位数，动态设置舍入精度
String displayedText = formatter.formatCellValue(cell);
int scale = displayedText.contains(".") ? displayedText.split("\\.")[1].length() : 0;
BigDecimal correctedValue = BigDecimal.valueOf(rawDoubleValue)
        .setScale(scale + 2, RoundingMode.HALF_UP)
        .stripTrailingZeros();

通过参考显示文本的小数位数，动态调整舍入精度，避免过度修正。

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