IT技术社区_专业开发者平台_最新编程教程与解决方案 -沐辰社区

Java案例怎么导出Excel数据？

wen java案例 11

本文目录导读：

Java案例怎么导出Excel数据？

  1. 目录导读
  2. 一、引言：为什么Java导出Excel仍是企业级开发的刚需？">一、引言：为什么Java导出Excel仍是企业级开发的刚需？
  3. 二、技术选型对比：POI、JXL、EasyExcel，谁更适合你的项目？">二、技术选型对比：POI、JXL、EasyExcel，谁更适合你的项目？
  4. 三、实战案例：基于Apache POI的Excel导出完整步骤">三、实战案例：基于Apache POI的Excel导出完整步骤
  5. 四、性能优化：百万级数据导出如何避免OOM？">四、性能优化：百万级数据导出如何避免OOM？
  6. 五、常见问题与避坑FAQ">五、常见问题与避坑FAQ
  7. 六、总结：从案例到生产，你还需要注意什么？">六、总结：从案例到生产，你还需要注意什么？

目录导读

  1. 引言：为什么Java导出Excel仍是企业级开发的刚需？
  2. 技术选型对比：POI、JXL、EasyExcel，谁更适合你的项目？
  3. 实战案例：基于Apache POI的Excel导出完整步骤
    • 1 环境准备与依赖引入
    • 2 创建Workbook与Sheet
    • 3 写入表头与数据行
    • 4 导出为.xlsx文件
  4. 性能优化：百万级数据导出如何避免OOM？
  5. 常见问题与避坑FAQ
  6. 从案例到生产，你还需要注意什么？

引言：为什么Java导出Excel仍是企业级开发的刚需？

在B/S架构的企业应用中，数据导出是最高频的功能之一，无论是报表统计、财务对账，还是用户列表导出，Excel格式因其兼容性强、无需额外软件即可打开的特性，成为数据交换的首选载体。

但很多开发者在实现「Java导出Excel」时，会遇到内存溢出、格式错乱、大数据量卡顿等问题，本文将通过一个具体的Java案例，手把手带你完成从零到生产的Excel导出实现，并引入搜索引擎中热门的优化策略与踩坑实录。

技术选型对比：POI、JXL、EasyExcel，谁更适合你的项目？

技术库 优点 缺点 适用场景
Apache POI 功能最全，支持.xlsx、.xls、公式、图表、样式 内存占用高，大数据量易OOM 中小规模（万级以下）或需复杂格式
JExcel（JXL） 轻量，上手快 只支持.xls，功能简陋，已停止维护 老旧项目，简单导出
EasyExcel 基于POI优化，带流式读写，内存友好 对复杂样式支持不如POI 大数据量导出（十万级以上），阿里巴巴推荐

如果你是新手或需应对大数据量,优先选EasyExcel；若需要高度定制化格式（如合并单元格、图表），则用POI，本文案例以Apache POI为例，因为它是大多数现有教程的基础，但我会在末尾提供EasyExcel的替代写法。

实战案例：基于Apache POI的Excel导出完整步骤

1 环境准备与依赖引入

在Spring Boot项目中，添加以下Maven依赖（以POI 5.2.5为例）：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>

注意：如果项目同时需要支持.xls（旧格式），需额外引入poi模块，但一般建议统一使用.xlsx。

2 创建Workbook与Sheet

// 1. 创建工作簿（支持.xlsx）
Workbook workbook = new XSSFWorkbook();
// 2. 创建Sheet
Sheet sheet = workbook.createSheet("用户数据");

关键问答：
Q：为什么不用HSSFWorkbook？
A：HSSF对应.xls（03版Excel），最大行数65536，列数256，已无法满足现代需求，XSSF对应.xlsx（07版后），行数可达104万，且支持更多样式。

3 写入表头与数据行

步骤： 创建行 → 创建单元格 → 设置值

// 3. 创建表头行
Row headerRow = sheet.createRow(0);
String[] headers = {"ID", "姓名", "邮箱", "注册时间"};
for (int i = 0; i < headers.length; i++) {
    Cell cell = headerRow.createCell(i);
    cell.setCellValue(headers[i]);
    // 可选：设置表头样式（加粗、背景色等）
    CellStyle headerStyle = workbook.createCellStyle();
    Font font = workbook.createFont();
    font.setBold(true);
    headerStyle.setFont(font);
    cell.setCellStyle(headerStyle);
}
// 4. 填充数据（假设从数据库获取）
List<User> userList = userService.listAllUsers();
int rowNum = 1;
for (User user : userList) {
    Row row = sheet.createRow(rowNum++);
    row.createCell(0).setCellValue(user.getId());
    row.createCell(1).setCellValue(user.getName());
    row.createCell(2).setCellValue(user.getEmail());
    // 日期处理：将Date转为字符串或设置单元格格式
    Cell dateCell = row.createCell(3);
    DataFormat format = workbook.createDataFormat();
    CellStyle dateStyle = workbook.createCellStyle();
    dateStyle.setDataFormat(format.getFormat("yyyy-MM-dd HH:mm:ss"));
    dateCell.setCellStyle(dateStyle);
    dateCell.setCellValue(user.getRegisterTime());
}

避坑提示：

  • 日期不要直接setCellValue(new Date())，否则Excel显示的是双精度数值，需通过DataFormat指定格式。
  • 每行数据量较大时,建议设置sheet.setColumnWidth()让列宽自适应，否则导出后需要手动拉宽。

4 导出为.xlsx文件（下载到客户端）

最常用的方式是通过HTTP响应输出流下载：

// 5. 设置响应头 + 导出
try (OutputStream os = response.getOutputStream()) {
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setHeader("Content-Disposition",
        "attachment; filename=users_" + System.currentTimeMillis() + ".xlsx");
    workbook.write(os);
    os.flush();
} finally {
    workbook.close(); // 一定记得关闭，释放临时文件
}

Q：为什么用finally关闭workbook？
A：XSSFWorkbook在写入时会创建临时文件在磁盘，如果不关闭，临时文件会残留，造成磁盘泄露。这是很多初学者会忽略的点。

性能优化：百万级数据导出如何避免OOM？

当数据量达到10万行以上时,POI默认会一次性将所有数据加载到内存，极易触发java.lang.OutOfMemoryError，以下是从搜索引擎综合来的几种主流方案：

方案1：使用SXSSFWorkbook（POI官方推荐）

SXSSFWorkbook是POI的流式版本，它只在内存保留最近的行（可设置窗口大小），旧行写入临时文件。

// 替换：new XSSFWorkbook() → new SXSSFWorkbook(100)
// 参数100表示内存中保留最近100行
Workbook workbook = new SXSSFWorkbook(100);
// 其余写法完全一样，导出完记得：
((SXSSFWorkbook) workbook).dispose(); // 清理临时文件

注意：SXSSFWorkbook不支持的公式和部分样式（如大部分图表），但基本的数据+样式是兼容的。

方案2：分Sheet导出

如果数据量超过单Sheet上限（104万行），或者用户明确要求分文件，可每50万行创建一个新Sheet。

方案3：使用EasyExcel的流式写出

// 依赖：easyexcel3.3.2
ExcelWriter builder = EasyExcel.write(response.getOutputStream(), UserVO.class)
    .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())
    .build();
WriteSheet writeSheet = EasyExcel.writerSheet("用户数据").build();
// 每次从数据库读1000行，写到Excel
PageHelper.startPage(page, 1000);
List<UserVO> list = userService.list();
builder.write(list, writeSheet);

优势：EasyExcel自带分批写入，无需手动管理窗口，内存开销低，适合10万级以上。

常见问题与避坑FAQ

Q1：导出的Excel打开时提示“文件损坏”或“格式错误”？

原因：最常见的是Workbook未被正确关闭，导致输出流不完整。
解决：确保使用try-with-resources自动关闭，或在finally中关闭。

Q2：导出的中文乱码怎么处理？

原因：HTTP响应头未设置正确字符编码。
解决：

response.setCharacterEncoding("UTF-8");
response.setHeader("Content-Disposition",
    "attachment; filename=" + URLEncoder.encode("用户数据.xlsx", "UTF-8"));

Q3：导出速度特别慢，如何加速？

优化点：

  • 使用SXSSFWorkbook代替XSSFWorkbook。
  • 减少样式创建：不要每行都创建新样式，复用已创建的样式对象。
  • 避免逐条查询数据库：采用分页批量读取。

Q4：导出时如何动态合并单元格？

示例：

// 合并第一行的第一列到第三列（表头居中）
sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 2));
// 注意：合并单元格后，原本后两列的值会被覆盖，需手动设置

从案例到生产，你还需要注意什么？

  1. 测试边界数据：导出前先验证空数据（数据为0列表），避免空白表格。
  2. 日志记录：每次导出记录操作人、导出时间和筛选条件，便于审计。
  3. 异步导出：如果数据量太大（>50万行），建议改用异步任务，生成文件后通过邮件/通知发送下载链接。
  4. 关注POI版本兼容性：POI 5.x后移除了旧API，升级时注意检查HSSFWorkbook等是否被弃用。

通过本文的Java案例，你已经掌握了从POI基础导出到性能优化的全链路技能。最后的建议是，如果项目刚起步或允许，直接使用EasyExcel作为默认导出方案，它会让你少踩很多坑，而掌握POI，是为了应对需要复杂格式的特殊场景。

延伸阅读提示：搜索「EasyExcel 大数据导出 内存优化」可获取更多实际生产中的调参策略。

上一篇Java案例如何实现邮件发送？

下一篇Java案例如何读取Excel文件？

相关文章

抱歉，评论功能暂时关闭!