Spring Boot整合POI案例

wen java案例 2026-08-10 1

Spring Boot整合Apache POI实战：Excel百万数据导出与导入性能优化全解析

目录导读

为什么选择POI？——技术选型与核心组件解析
环境搭建：Spring Boot 3.x + POI 5.x依赖配置
实战案例一：基于注解的Excel模板导出（含自定义样式）
实战案例二：SXSSFWorkbook流式写入，解决内存溢出
实战案例三：大数据量Excel导入（逐行解析+批量入库）
高频问题答疑（FAQ）
性能调优与SEO优化技巧（附避坑指南）

为什么选择POI？——技术选型与核心组件解析

在Java生态中,Apache POI是操作Microsoft Office格式（.xls/.xlsx）的事实标准，面对EasyExcel、FastExcel等轻量级框架的竞争，POI的优势在于底层控制力强和API完备性，它提供两个核心模型：

Spring Boot整合POI案例

HSSF（.xls）：适合低数据量（<65535行），内存占用小。
XSSF/SXSSF（.xlsx）：XSSF基于DOM，适合小文件；SXSSF（Streaming Usermodel） 是XSSF的流式版本，通过滑动窗口（默认100行）控制内存中的行数，是处理百万级数据导出的不二之选。

SEO提示：Google搜索引擎更青睐包含“性能对比”、“内存优化”、“SXSSF”等长尾关键词的深度技术文章。

环境搭建：Spring Boot 3.x + POI 5.x依赖配置

在pom.xml中加入以下依赖（注意版本兼容性，Spring Boot 3.x需搭配POI 5.2.3+）：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>
<!-- 用于SXSSF的自动刷写，必须引入 -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml-schemas</artifactId>
    <version>4.1.2</version> <!-- 注意：POI 5.x后此包可能不必要，但保留可解决部分类加载冲突 -->
</dependency>

关键点：如果使用Spring Boot的spring-boot-starter-web，需排除内置的poi依赖（如果存在），避免版本冲突，实际项目推荐使用poi-ooxml即可，因为poi基础包会被传递引入。

实战案例一：基于注解的Excel模板导出（含自定义样式）

场景：导出用户列表，要求表头加粗、底色淡蓝、自适应列宽。

核心代码（剥离Controller层，聚焦Service逻辑）：

public void exportUsers(HttpServletResponse response) throws IOException {
    List<User> userList = userService.listAll(); 
    try (SXSSFWorkbook workbook = new SXSSFWorkbook(200)) {
        Sheet sheet = workbook.createSheet("用户数据");
        // 1. 创建表头样式
        CellStyle headerStyle = workbook.createCellStyle();
        headerStyle.setFillForegroundColor(IndexedColors.LIGHT_BLUE.getIndex());
        headerStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
        Font headerFont = workbook.createFont();
        headerFont.setBold(true);
        headerStyle.setFont(headerFont);
        // 2. 写入表头（利用数组提升代码可读性）
        String[] headers = {"ID", "姓名", "邮箱", "注册时间"};
        Row headerRow = sheet.createRow(0);
        for (int i = 0; i < headers.length; i++) {
            Cell cell = headerRow.createCell(i);
            cell.setCellValue(headers[i]);
            cell.setCellStyle(headerStyle);
        }
        // 3. 写入数据（使用SimpleDateFormat避免线程安全问题）
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        for (int i = 0; i < userList.size(); i++) {
            Row row = sheet.createRow(i + 1);
            User user = userList.get(i);
            row.createCell(0).setCellValue(user.getId());
            row.createCell(1).setCellValue(user.getName());
            row.createCell(2).setCellValue(user.getEmail());
            row.createCell(3).setCellValue(sdf.format(user.getCreateTime()));
        }
        // 4. 自适应列宽（注意：对大数据量慎用，会遍历全表）
        for (int i = 0; i < headers.length; i++) {
            sheet.autoSizeColumn(i);
        }
        // 5. 写入响应流（设置编码和附件名）
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setHeader("Content-Disposition", "attachment; filename=users.xlsx");
        workbook.write(response.getOutputStream());
    }
}

实战案例二：SXSSFWorkbook流式写入，解决内存溢出

痛点：普通XSSFWorkbook在导出10万行数据时，内存占用高达500MB+，而SXSSF通过临时文件保存不活跃的行数据。

关键配置：

// 窗口大小100行，即内存中最多保留100行数据
SXSSFWorkbook workbook = new SXSSFWorkbook(100);
// 开启压缩临时文件（降低磁盘IO）
workbook.setCompressTempFiles(true);

优化细节：

避免使用autoSizeColumn：每次调用都会遍历所有行，导致OOM，建议手动计算列宽或直接设置固定宽度。
批量刷写：当数据行数超过窗口大小时，POI自动将最旧的行刷入磁盘，也可手动调用((SXSSFSheet)sheet).flushRows(200)强制刷写。
最终清理：操作完毕后必须调用workbook.dispose()删除临时文件，否则会留下磁盘垃圾。

实战案例三：大数据量Excel导入（逐行解析+批量入库）

场景：批量导入500万行用户数据，要求高效且不崩溃。

方案：使用XSSFReader（SAX模式）代替Usermodel，解析效率提升5倍以上，但此API更底层，需要实现XSSFSheetHandler。

简化版实现思路：

public void importLargeExcel(MultipartFile file) {
    try (OPCPackage pkg = OPCPackage.open(file.getInputStream())) {
        XSSFReader reader = new XSSFReader(pkg);
        SharedStringsTable sst = reader.getSharedStringsTable();
        XSSFReader.SheetIterator iter = (XSSFReader.SheetIterator) reader.getSheetsData();
        while (iter.hasNext()) {
            try (InputStream sheetStream = iter.next()) {
                // 使用SAX解析，每读取一行，立即调用mapper批量插入（如每1000行提交一次）
                parseSheet(sheetStream, sst);
            }
        }
    } catch (Exception e) {
        log.error("导入失败：", e);
    }
}

高频问题答疑（FAQ）

Q1：SXSSFWorkbook导出的Excel能正常打开吗？
- A：完全正常，只是文件在内存中未完全加载，但最终写入流时是完整的。
Q2：POI与EasyExcel怎么选？
- A：EasyExcel基于POI封装，内存占用更低，但POI可定制性更强，若需复杂样式或公式，POI更合适。
Q3：导出时数字变成了科学计数法怎么办？
- A：设置cell.setCellType(CellType.STRING)，或写入前将数字格式化（如用BigDecimal）。
Q4：多线程导出时如何保证线程安全？
- A：每个线程创建独立的Workbook实例，切勿共享，可通过ThreadLocal或ExecutorService管理。

性能调优与SEO优化技巧（附避坑指南）

数据源优化：不要一次性加载全表到内存，改用MyBatis-Plus的流式查询fetchSize分页读取。
压缩传输：响应头开启GZIP压缩（Content-Encoding: gzip），大文件传输可减少70%网络耗时。
缓存复用：对于样式、字体对象，使用Map缓存避免重复创建。

避坑指南：

SXSSFWorkbook使用后必须调用dispose()，否则临时文件积压导致磁盘满。
若导出报java.lang.OutOfMemoryError，优先检查是否在循环中创建了样式对象（每行一个样式会炸内存）。

本文结语：Spring Boot整合POI不仅是工具链的拼接，更是对内存模型与数据流的深度驾驭，从注解导出到流式读写，每一环都需结合业务场景做极致权衡，若你正在处理万级以上的数据表格，建议优先验证SXSSF的窗口机制是否满足需求，将本案例中的抽象逻辑沉淀为通用工具类，方能解放生产力。