Spring Boot实现多结构Excel数据入库及非必填列适配方案

核心思路是放弃依赖列索引，通过表头列名与实体字段的映射来处理数据，这样不管非必填列是否存在、顺序如何，都能正确匹配赋值。

实现步骤 #

1. 解析Excel表头，构建列名-索引映射 #

先读取Excel的第一行（表头行），将每个列名对应的列索引存入Map，后续每行数据都通过这个映射来定位单元格。

2. 基于映射处理每行数据 #

• 必填字段：直接通过映射获取对应单元格（因为必填列始终存在，无需判断）
• 非必填字段：先检查映射中是否存在该列名，存在则读取单元格值，不存在则跳过或设默认值

完善后的代码示例 #

// 依赖Apache POI处理Excel，需引入poi/poi-ooxml依赖
import org.apache.poi.ss.usermodel.*;
import java.util.HashMap;
import java.util.Map;
import java.util.Arrays;
import java.util.List;

public void processExcelSheet(Sheet sheet) {
    // 1. 解析表头，建立列名到索引的映射
    Row headerRow = sheet.getRow(0);
    if (headerRow == null) {
        throw new IllegalArgumentException("Excel文件无表头行");
    }
    Map<String, Integer> columnNameIndexMap = new HashMap<>();
    for (int i = 0; i < headerRow.getLastCellNum(); i++) {
        Cell cell = headerRow.getCell(i);
        if (cell != null) {
            // 统一去空格，避免表头格式不一致导致匹配失败
            String columnName = cell.getStringCellValue().trim();
            columnNameIndexMap.put(columnName, i);
        }
    }

    // 2. 校验必填列是否存在
    List<String> requiredColumns = Arrays.asList("Column1", "Column2"); // 替换为你的实际必填列名
    for (String col : requiredColumns) {
        if (!columnNameIndexMap.containsKey(col)) {
            throw new IllegalArgumentException("Excel缺失必填列：" + col);
        }
    }

    // 3. 处理数据行（从第2行开始，索引为1）
    for (int j = 1; j <= sheet.getLastRowNum(); j++) {
        Row currentRow = sheet.getRow(j);
        if (currentRow == null) {
            continue;
        }

        Student student = new Student();

        // 处理必填字段（Column1对应id，Column2对应name，根据实际业务调整）
        Integer idColIndex = columnNameIndexMap.get("Column1");
        Cell idCell = currentRow.getCell(idColIndex);
        student.setId(getCellValueAsInt(idCell));

        Integer nameColIndex = columnNameIndexMap.get("Column2");
        Cell nameCell = currentRow.getCell(nameColIndex);
        student.setName(getCellValueAsString(nameCell));

        // 处理非必填字段：Column3
        if (columnNameIndexMap.containsKey("Column3")) {
            Integer col3Index = columnNameIndexMap.get("Column3");
            Cell col3Cell = currentRow.getCell(col3Index);
            student.setColumn3(getCellValueAsString(col3Cell)); // 根据字段类型调整转换逻辑
        }

        // 处理非必填字段：Column4
        if (columnNameIndexMap.containsKey("Column4")) {
            Integer col4Index = columnNameIndexMap.get("Column4");
            Cell col4Cell = currentRow.getCell(col4Index);
            student.setColumn4(getCellValueAsString(col4Cell));
        }

        // 保存到数据库
        // studentRepository.save(student);
    }
}

// 工具方法：将单元格值转为Integer
private Integer getCellValueAsInt(Cell cell) {
    if (cell == null) {
        return null;
    }
    switch (cell.getCellType()) {
        case NUMERIC:
            return (int) Math.round(cell.getNumericCellValue());
        case STRING:
            String strVal = cell.getStringCellValue().trim();
            return strVal.isEmpty() ? null : Integer.parseInt(strVal);
        default:
            return null;
    }
}

// 工具方法：将单元格值转为String
private String getCellValueAsString(Cell cell) {
    if (cell == null) {
        return null;
    }
    switch (cell.getCellType()) {
        case STRING:
            return cell.getStringCellValue().trim();
        case NUMERIC:
            // 数值型转字符串，可根据需求调整格式
            return String.valueOf((int) Math.round(cell.getNumericCellValue()));
        case BOOLEAN:
            return String.valueOf(cell.getBooleanCellValue());
        default:
            return null;
    }
}

额外注意事项 #

• 依赖引入：在pom.xml中添加poi和poi-ooxml依赖，同时支持xls和xlsx格式
• 表头匹配：建议将表头列名统一转为大写/小写后再存入映射，避免大小写差异导致匹配失败
• 异常处理：可根据业务需求添加更完善的异常捕获逻辑，比如单元格类型不匹配的情况
• 空值处理：工具方法中已处理空单元格的情况，可根据业务需求调整默认值

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