JXLS 讀取 Excel 長數字自動轉科學計數法問題的徹底解決方案

問題現象

使用 JXLS 導入 Excel 時，長度超過 10 位的數字（如 12345678912）被自動轉為科學計數法 1.2345678E10，導致業務主鍵、身份證號、銀行卡號等關鍵字段數據失真。

根本原因

Excel 單元格格式為「常規」或「數值」時，POI 底層讀取返回 NumericCellValue，JXLS 默認調用 getNumericCellValue() 獲取 double，超出精度範圍自動科學計數。

三種解決方案（按推薦度排序）

方案一：模板預設單元格為文本格式（最簡單、零代碼改動）

1. 選中 Excel 模板中對應列
2. 右鍵 →「設定單元格格式」→「文本」
3. 保存模板，JXLS 讀取時直接返回字符串，保持原始數字不變

方案二：自定義 CellProcessor 強制文本讀取

public class StringCellProcessor implements CellProcessor {
    @Override
    public Object process(Cell cell, Context context) {
        if (cell.getCellType() == Cell.CELL_TYPE_NUMERIC) {
            // 禁用科學計數法，獲取完整數字字符串
            DataFormatter formatter = new DataFormatter();
            return formatter.formatCellValue(cell);
        }
        return cell.getStringCellValue();
    }
}

配置映射：cellProcessors.put("id", new StringCellProcessor());

方案三：數據預處理階段轉換

在 JXLS 讀取前，用 Apache POI 遍歷工作表，將目標列 setCellType(Cell.CELL_TYPE_STRING)，再交給 JXLS 處理。

驗證清單

最佳實踐建議

• 🔑 業務主鍵、識別碼類字段**務必在模板中設為文本格式**
• 🔑 導入功能上線前，準備包含長數字、前導零、科學計數法邊界值的測試用例
• 🔑 生產環境異常日誌中記錄原始 Cell 原始值與解析後值，便於快速定位

「模板文本格式化」一勞永逸，配合「CellProcessor 兜底」，徹底告別 JXLS 讀取長數字變科學計數法的數據質量隱患。